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_ PREFACE 


MANUAL OBJECTIVES 
This manual is designed as a reference for users who have had _ some 
exposure to text-editing computer programs. It is not intended as a 


tutorial introduction, either to text editors in general or to the SOS 
editor in particular. 


INTENDED AUDIENCE 


If you have read the introduction to SOS in the VAX/VMS Primer and 
want to know more about SOS, this is the manual for you. 


If you are familiar with some other text editing program -- either a 
DIGITAL text editor or another -- you can use this manual to gain 
familiarity with SOS. The tables and figures will prove helpful in 


this familiarization. Later, you can study this manual to learn 
details of SOS commands and features. 


ASSOCIATED DOCUMENTS 
The following documents may also be useful. 
@ VAX-11 Information Directory and Index 


@e VAX/VMS Primer 


CONVENTIONS USED IN THIS MANUAL 


In examples of user-system dialog, the text that you type appears in 
red. For example: 


KFG003 700 
This means that after the SOS prompt (*) you type P500:700 followed by 
a carriage return. The examples in this manual do not show the <RET> 
symbol when it is used as a command line terminator. 


The following symbols represent special keys on the terminal keyboard: 


ESC The escape key (labeled ESC, ALT, SEL, or PRE, depending on 
the terminal) 


vii 
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The carriage return key (labeled CR or RETURN) 
QED The delete key (labeled DEL, RUB, or CAN) 
@ The line feed key 
The space bar 


FE) 
oo 


The tab key or <CTRL/I> (see below) 
The backspace key 
The following symbols stand for various control functions, which you 


initiate by pressing the given key while holding down the CTRL key. 
Section 1.2 discusses these control functions. 


CTRL) GIRLS) 
GIRL) TAL) 
€TRE/O) TAL) 
GALA) €TRLY) 


Brackets [] indicate optional parts of an argument within a particular 
command string. The exceptions to this convention are directory and 
file specification, in which one set of brackets must be typed. 
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SUMMARY OF TECHNICAL CHANGES 


The following changes have been made to the VAX-1ll]l Text Editing 
Reference Manual for Version 2.0. 


l. 


SOS is now the only editor that is documented in this manual. 


All 


information about the batch-oriented editor SLP has been 


made part of the VAX-11 Utilities Reference Manual, 


The following new features have been added to the SOS text 
editor: 


ae 


The sequence of characters <CTRL/A> <ESC> which allows 
you to change from Input mode to Alter mode. This new 
feature is described in Chapter 5. 


The new switch /NUMBERS, which controls the printing of 


line numbers. This new feature is documented in Chapter 
6. 
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CHAPTER 1 


INTRODUCTION TO SOS 


SOS is a line-oriented, interactive text-editing program. Using it, 
you work on line to the computer, carrying on a dialogue with the 
program aS you create or modify a file, (SOS stands for SON OF 
STOPGAP, an earlier editor.) Unlike many line-oriented editors, SOS 
has features that allow you to examine and change text, character by 
character. You can use SOS to perform the following functions: 


e Examine, create, and modify ASCII text files 


@e Search for and/or change one or more arbitrary text strings, 
with the option to verify each change before it is made 


@ Merge parts of one file into another 
e Create a file that is a subset of another file 


SOS is line-oriented, so it works with line-numbered text files. If 
you edit a file that does not have line numbers, the editor adds line 
numbers to the text lines. When SOS writes your file to disk, it 
includes the line numbers unless you specifically request that it omit 
them. 


SOS requires you to be concerned with line numbers within the file. 
For most SOS commands, a line number or a range of line numbers 
specifies the text to be operated on. When you insert, delete, move, 
or copy text, SOS is programmed to keep line numbers in ascending 
order within each "page" of text. To this end, SOS may refuse to 
accept more inserted text, or insert "page marks," or warn you to 
renumber the lines in the file. 


SOS is more interactive than many other editors. In some modes of 
operation, it responds on a character-by-character basis to what you 
type. This degree of interactivity may be new to some users 


accustomed to less interactive editors, which always expect a command 
line terminated by a carriage return. 


For example, one SOS feature that exhibits this character-by-character 
interactivity is Alter mode. This special mode lets you make changes 
within a line of text, interactively. Alter mode has its own commands 
and syntax; it functions essentially as an editor within an editor. 
This mode is discussed in detail in Section 5.1. 


Advanced features of SOS allow you considerable flexibility in 
searching for a string of text (see Section 7.1) and allow you to 
specify blocks of text by content, instead of by line number (see 
Section 7.2). 


Many SOS parameters and switches, which you can _ set, control the 
editor's default values. (See Section 5.21 and Chapter 64.) 
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1.1 INITIATING AND TERMINATING SOS 


SOS is invoked by the DCL command EDIT. Initiate SOS by typing one of 
the following commands in response to the DCL prompt: 


¢ EDIT 

$Filetfile-srec 
or 

$ EQIT file-srec 
or 


$ EQIT/OUTFUTsouteut-file-serec FPile-srec 


In the first form above, SOS prompts you for the specification of the 
file you want to edit or create. (See the chapter on file 
manipulation in the VAX/VMS Primer for an introduction to file 
specifications, ) 


In the second form, you explicitly type the file specification. If 
the file does not exist, SOS creates it. 


In the third form, you specify both the file you want to edit and the 
file to which you want the edits to be written. If you do not 
designate a file name or file type in the output file specification, 
SOS defaults to the file name and type of the input file. 


In the second and third forms above, you can optionally append 
qualifiers, separated by slashes (/), to the file specification. 


There are several ways to terminate SOS; they are discussed in detail 
under the End command (E) in Section 5.4. Usually, you give the 
command E after SOS'sS prompt (*): 


xE 
CUfile-geeci 


$ 


Upon terminating, SOS writes an output file containing all the 
modifications you made in editing the file. The original file is not 
changed. The specification SOS uses for the output file (unless you 
supply it explicitly) has a version number higher by 1 than the latest 
version of the original file. 


1.2 CONTROL CHARACTERS 


All the usual VAX/VMS control characters can be used.in most contexts 
within Sos. However, some of these characters are not effective in 
Alter mode. For details, see the Alter command in Section 5.1. The 
control characters are described briefly below. 


CTALID) This character, typed before an input line is 


complete, deletes the entire line being input. You 
can then retype the line. CLD is generated by 


typing u or U while holding down the CTRL key. It is 
echoed as “U. 


TALS This character, typed while output is in progress, 
suspends the output until you type . 


is not echoed. 
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This character resumes output suspended by . 
is not echoed. 


CTRL) This character interrupts output in progress, Sos 
continues to send output to the terminal, but the 
terminal discards it. SOS prompts when it is ready 
for further input; the prompt depends on which mode 
the editor is in. is not echoed. 


GALA) This character, typed before an input line is 
completed, redisplays the entire line. GRA) is 


echoed as “*R. 


GTALYY) This character immediately gets the attention of the 
DCL interpreter. You can then type any legal DCL 
command, such as SHOW or CONTINUE. If the DCL command 
does not change the SOS image, you can resume SOS by 
typing the DCL command CONTINUE. 


CTRL) This character interrupts whatever command is in 
progress and returns you immediately to Edit mode, 
Any changes already made by the command (for example, 
by an Alter or Substitute command) are incorporated 
into the file. is echoed as “*C. 


1.3 USE OF ESCAPE 


Some SOS commands use the eScape character, & , aS part of their 
syntax. On some terminals, the key corresponding to the escape 
character is labeled ESC; on others, it is labeled ALT (ALTmode), SEL 
(SELect), or PRE (PREfix). 


The escape character is a message delimiter in the VAX/VMS- system. 
Although many VAX-11 programs accept escape interchangeably with 
carriage return to indicate the end of input, SOS does not, You can 
use escape only in the contexts in which it is legal. 


In this manual, ESC indicates that you should press the escape key 
on the terminal. 


SOS echoes the escape as $. Do not confuse this character with the 
dollar-sign character (S$), shift-4. The dollar sign normally has no 
special meaning to sos.1l 


1.4 USE OF DELETE 


The delete character OED) deletes the previous input character. On 
terminal devices, the delete key may be labelled DEL (DELete), RUB 
(RUBout) or CAN (CANcel). Successive G characters remove previous 
characters one by one. Any number of characters can be deleted, up to 
the last carriage return or escape typed. The way this deletion is 
represented on your terminal depends’ on the type of terminal. On 
video display terminals, the characters are physically deleted and the 
cursor is moved backward. On hard-copy terminals, the deleted 
characters are echoed in reverse order, and set off within backslashes 


(\). 


1 The dollar-sign character is significant only when the parameter 
ESCAPE is set, enabling you to insert escape characters into a text 
file. See Sections 5.22 and 6.1. 
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1.5 UPPER- AND LOWERCASE CHARACTERS 


Whether a terminal generates all uppercase characters, or both’ upper- 
and lowercase characters, depends on the type of terminal and on how 
the terminal characteristics are set. (Terminal characteristics are 
changed by the DCL SET command -- see the VAX/VMS Command Language 
User's Guide and the VAX/VMS Primer.) SOS accepts either uppercase or 
lowercase characters in commands, or a combination of the two. In the 
examples in this manual, upper- and lowercase characters are used 
interchangeably in commands. SOS distinguishes between upper- and 
lowercase characters in text that you enter into a file. 


Normally, SOS does not distinguish uppercase from lowercase when 
searching for a given text string. Thus, a search for the text string 
"holiday," using the Find or Substitute commands, would be _ satisfied 
if SOS encountered any of the following: holiday, Holiday, or 
HOLIDAY. (See Chapter 5 for a description of these search 
commands.) You can request SOS to distinguish upper- and lowercase 
characters either by setting the EXACT switch (see Section 6.2) or by 
using an option of the Find and Substitute commands. 


CHAPTER 2 


MODES OF OPERATION 


SOS operates in a number of different modes. A mode of operation is 
defined as a state of SOS in which the editor interprets terminal 
input in a distinctive way. You can tell which mode SOS is operating 
in by the kind of prompt displayed. 


SOS has seven modes and two submodes of SOS operation. There are 
paths between the various modes, and each mode has its own prompt. 
You can initiate the editor in one of three modes: Input, Read-only, 
or Edit. Edit mode is the heart of SOS, from which the other modes 
can be accessed. Two Submodes of Decide mode correspond to Alter and 
Alter/insert modes, but communicate only with Decide mode. 


In different modes, SOS prints different prompts when it is ready to 
accept input. It then accepts a certain set of commands, each set 
unique to its mode. In some modes, SOS interprets input on a 
character-by-character basis, so that you need not type <RET> after a 
command. In different modes, SOS has different ways of informing you 
that you have typed unacceptable input. 


As mentioned above, SOS performs differently depending upon the mode 
in which it is initiated: 


e In Input mode, SOS accepts text you type and adds it to the 
file. 


@e In Read-only mode, you can only search and display the 
file; you cannot change it. 


e In Edit mode, you issue most of the commands to display and 
change a file. From Edit mode you can move to any. other mode, 
or you can exit to DCL. 


Four other modes of SOS operation are accessible from Edit mode. They 
are Copy-file, Decide, Alter, and Alter/insert. 


e Copy-file mode lets you to copy all or part of one file into 
another. You can search and display the copy file to locate 
the text to be copied. 


e Decide mode is used in conjunction with the Substitute command 
(see Section 5.15). You can issue a Substitute command to 
replace all occurrences of one text string with another string 
within a given range of text. -If you specify Decide mode, you 
can choose on a case-by-case basis whether or not to make’ the 
substitution, or you can enter Alter mode to make more 
extensive changes within a line. 
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e Alter mode lets you edit character by character within a line. 
In this special intraline mode, each character that you type 
is a command that SOS acts upon immediately; you need not 
type <RET>. 


e Alter/insert mode lets you insert text that you type into the 
text file. In this mode, most control characters are treated 
as text; they do not perform their usual control functions. 


Decide mode has two submodes: Decide Alter and Decide Alter/insert. 
In these submodes, SOS acts almost exactly as it does in Alter mode 
and Alter/insert mode, respectively. The only difference is that 
these submodes are accessed from Decide mode, not from Edit mode. 
When you exit from the submodes you return to Decide mode, not to Edit 
mode. 


The following sections discuss the seven modes and two submodes of SOS 
in general terms, 


2.1 INPUT MODE 


In SOS Input mode you can insert one or more new lines of text into a 
file. You enter Input mode either directly from DCL or from Edit 
mode. 


SOS starts up in Input mode if, when you give the DCL EDIT command, 
you specify .a file that does not exist. SOS creates a file with the 
specified name and waits for you to type text to put into it. An 
example follows. 


* EQIT NEW.FOR 
TNFUT 20841 PT CMANCHINEW. FOR S 1 
OOLOG 


Notice that SOS types the word INPUT before the file specification to 
remind you that it is creating the file and entering Input mode. 


In Input mode, the prompt is the line number that SOS assigns to the 
next line to be typed. Initially, SOS numbers lines by 100s. 


To correct typing errors while entering text, use any of the terminal 
control characters described in Section 1.2. 


When input is complete, switch to Edit mode by typing an escape 
character. You can type escape either at the end of a line of input, 
or after SOS has prompted with the next line number. SOS then prompts 
with an asterisk (*), indicating that you are in Edit mode, 


You can store the file and end SOS at this point by typing the command 
E. Or, before terminating, you can make changes to the text you have 
just typed by using other Edit-mode and Alter-mode commands. 


You can also pass directly from Input mode to Alter mode by typing the 
character sequence <CTRL/A> <ESC> at the current position on a given 
line. See Section 5.7 for further information, 


To enter Input mode again from Edit mode -- if you have more whole 
lines of text to put into the file -- use the Input or Replace 
commands (described in Sections 5.7 and 5.14, respectively). 
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2.2 READ-ONLY MODE 


Use Read-only mode if you only need to examine a file and do not 
intend to modify it, or if you need to look at a file that is 
protected against your writing it. Start SOS in this mode by 
appending the qualifier /READONLY to the file specification: 


* EDIT PAYROLL. MST/READONLY 


REARS ORAL SC CORFIFPAYROLL «MGT $3 
Fok 


Note that SOS types the word READ before the file specification, and 
that R* is the prompt in Read-only mode. 


Only nine commands are legal in Read-only mode (see Chapter 5): End, 
Find, List, Print, Save World, Move Position, Give Parameter, Set 
Parameter, and Command File. These commands do not modify the file. 
Any other commands, which would modify the file, result in the error 
message COMMAND INVALID FOR READ ONLY FILE. 


Read-only mode is the most efficient way to use SOS if you do not need 
to modify a file. It is efficient because SOS does not copy the file 
to a temporary file as it does in Edit mode. See Chapter 8 for 
details. 


SOS allows you to change from Edit mode to Read-only mode, provided 
you have not modified the input file since you entered Edit mode. To 
change mode to Read-only, type the SOS switch /READONLY at the Edit 
mode prompt (*). (SOS switches are described in Section 6.2.) 


2.3 EDIT MODE 


Edit mode constitutes the main part of SOS. You can switch to any of 
the other modes of operation from Edit mode, and you can return to 
Edit mode from any of them. (You can switch to Read-only mode _ from 
Edit mode only if you have not modified the file; see Section 2.2.) 


SOS accepts 24 commands in Edit mode. Most are represented by a 
single character, and most take arguments in a predetermined syntax. 
Table 2-1 lists the names and single-character forms of the commands, 
and gives a brief summary of their functions. For complete 
descriptions of the commands, see Chapter 5. 


Initiate SOS in Edit mode by giving the file specification of a file 
that already exists, either on the EDIT command line or in response to 
SOS's prompt. For example: 


hy 
$F ile? TESTBLO.MAC 





1 


EMITS OBAL Ss CHENDIRIRSITESTRLO. MACE S 
x 


SOS prints the word EDIT before the file specification, indicating 
Edit mode. The prompt for this mode is an asterisk (*). 


For details on the operation of each Edit-mode command, see Chapter 5. 
Table 5-1 in that section summarizes the command syntax. Most 
commands take as an argument a line number, or a range of line 
numbers, indicating what text SOS is to operate on. Page numbers may 
also appear if the file is divided into pages. The formats of line 
numbers, page numbers, and ranges are given in Chapter 3. 
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Edit-Mode Commands: 


Delete 
End 


Find 


Help 


Input 


Join 


Kill page mark 


List 


Mark 
reNumber 
Print 


Replace 


Substitute 


Transfer 


Save World 


eXtend 


Move Position 


Give Parameter 


Set Parameter 


Execute Command File 





Table 2-1 
Form and Function 
Meaning 
Enter Alter mode for intraline, 


character-by~-character editing. 

Copy a range of lines to another place 
within a file, or from another file. 
Optionally, enter Copy-file mode. 


Delete a range of lines. 


End SOS, return to DCL. 

Search for the occurrence of one or 
more specified strings of text. 

Print Help package on terminal. 

Enter Input mode to insert lines of 


text. 
Join two text lines into one line. 
Delete a page mark. 


List a range of lines on the printer or 
to a file. 


Insert a page mark. 
Renumber a range of lines, 
Print a range of lines on the terminal. 


Delete a range of lines and enter Input 
mode. 


Replace one or more text strings with 
other string(s) in a range of lines. 
Optionally, enter Decide mode. 


Copy a range of lines to a new location 
and delete the original lines. 


Write a new file containing all the 
changes made so far. 
Enter Alter/insert mode to add text to 


the end of a line. 
Reset the position of the current line. 


Give the value of Sos internal 


parameter or switch. 


an 


Reset an SOS parameter or switch, 


Execute the SOS commands contained in a 
command file. 


Print next line. 
Print previous line. 
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2.4 COPY-FILE MODE 


Copy-file mode allows you to copy all or part of one file into another 
file at a specified location. Furthermore, it lets you search through 
and display the copy file to locate the exact part you want to copy. 


Enter Copy~file mode by using the Edit-mode command Copy with the 
qualifier /C (see Section 5.2). For example, to search the file 
SUBRLIB.FOR and copy part of it after line 100 into the file being 
edited, type: 


XC 1LOO@ SUBRL IE. FOR/C 

Cx 
Note that C* is the prompt for this mode. The copy file is opened 
read-only. Thus, only commands that do not change the file are legal, 


as in Read-only mode. The commands most often used are Print and 
Find. 


To exit from Copy-file mode, use the command E. (Do not confuse this 
command with the Edit-mode command E, with which you exit to DCL.) SOS 
then prompts for the range of lines to copy. When you supply the 
range, the copy operation is completed and you return to Edit mode. 


Copy-file mode is described in detail in Section 5.2.1. 


2.5 DECIDE MODE 
The SOS command Substitute (see Section 5.15) allows you to _ replace 
arbitrary strings of text with other strings. Decide mode, entered by 
way of the Substitute command, lets you decide, line by line, whether 
or not to make the specified substitution. 
For each line in which a substitution is called for, SOS displays’ the 
“modified line and prompts with D* for your decision. You reply with a 
single character. (No <RET> is needed; SOS reads and acts upon. the 
single character that you type.) If you reply with an illegal 
character, SOS repeats the prompt. 
The options you can exercise in Decide mode include: 

e Yes, make the change as shown. 

e No, do not make the change. 

@ Enter Decide Alter mode with the change already made. 


e Make the change, and make all further changes automatically, 
without decision. 


e Return immediately to Edit mode. 


Decide mode is described in detail in Section 5.15.3. 


MODES OF OPERATION 


2.6 ALTER MODE 


Use Alter mode to make minor changes within a line of text. In this 
mode, you can perform the following functions: 


e Insert or delete single or multiple characters or words within 
a line 


@ Move forward or backward within a line, either by character(s) 
or word(s) 


@e Move to the next occurrence of a given character within a line 


e Delete all text until the next occurrence of a given character 
within a line 


e Split a line at any point 
e Insert control characters into a line 


In Alter mode, SOS does not echo single-character commands that you 
type; if you type an illegal command, a bell rings on the terminal. 
SOS displays the line of text that you are editing as you build it, 
that is, as you insert, delete, and pass over characters and words. 


You enter Alter mode by issuing the Alter command from Edit mode, or 
by typing the character sequence <CTRL/A> <ESC> from Input mode. 
(This special sequence is discussed in Section 5.7.) The prompt in 
Alter mode is the line number’ followed by a tab, the same as the 
prompt for Input mode. You can easily determine which mode SOS is in, 
however, by observing the behavior of the terminal (for example, 
commands are not echoed in Alter mode). 


There are several ways to return to Edit mode. The most common is_ to 
type <RET> (unless you entered Alter mode by typing the character 
sequence <CTRL/A> <ESC>; see Section 5.7). SOS prints the remainder 
of the line, if any, and gives the Edit-mode prompt (*). 


Alter mode is described in detail in Section 5.1. 


2.7 ALTER/INSERT MODE 


In Alter/insert mode, characters that you type are inserted into the 
text. Most control characters (with seven exceptionsl) are inserted 
into the text without performing their usual special functions. For 
example, <CTRL/U> does not discard the input line. (See the VAX/VMS 
Command Language User's Guide for control-character functions.) 


You enter Alter/insert mode from Alter mode by giving the I or R 
command, or from Edit mode by giving the eXtend command. SOS does not 
prompt in Alter/insert mode. You return to Alter mode by typing 
<ESC>, or to Edit mode by typing <RET>. 


Alter/insert mode is described with the Alter-mode command I in 
Section 5.1. 


1 The exceptions are <RET>, <ESC>, <DEL>, <LF>, <CTRL/C>, <CTRL/R>, 
and <CTRL/Y>. 
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LINE NUMBERS, PAGE NUMBERS, AND RANGES 


Many SOS commands take as one argument a line number or a range of 
line numbers, indicating what text the command is to operate on. This 
section describes how to use line numbers and page numbers to form 
such ranges. It also discusses shorthand characters for line and page 
numbers, line and page number offsets, and SOS-supplied defaults in 
range specifications. The examples in this section use the Print 
command, which displays lines of text. 


3.1 LINE NUMBERS 


SOS line numbers are 5-digit decimal numbers, such as 00400 or 13280. 
Line numbers may not be greater than 65535. When you type a line 
number, you need not type leading zeros: thus typing 50 is the same as 
typing 00050. 


When SOS first numbers a file, it assigns line numbers starting at 100 
and ascends by hundreds. (You can change these defaults with the Set 
Parameter command; see Sections 5.21 and 6.1.) Line numbers are 
always in ascending order on any given page. 


The following is an example of the Print command using a_ single line 
number: 


KP IOO 
00300 } VATE? IS-AUG-77 
x 


3.2 PAGE NUMBERS 


If a file is large, or if the information it contains falls naturally 
into a number of logical divisions, you can divide the file into 
pages. For example, if an assembly-language source file contains a 
number of logically independent sections, you could place each section 
in this file on a separate page. 


The Edit-mode commands Mark and Kill Page Mark, respectively, insert 
and delete page marks in a file (see Sections 5.9 and 5.11). 
Sometimes SOS automatically inserts page marks when you give a Copy or 
Transfer command, depending on how the line numbers fall. 
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The complete specification for a line position in an SOS text file can 
contain both a line number and a page number. A slash (/) separates 
the two. For example: 


KP L1O/2 


This means print line 110 on page 2. 


3.3 POSITIONS 


A position marks a single line in a text file. Some commands take a 
position aS an argument, as for example the Mark command (Section 
5.11). Other commands take a range aS an argument (See the next 
section); a range can be specified by giving two positions as its end 
points. A position consists of a line number and a page number. You 
can omit either one; if you do, SOS supplies a default, as shown 
below. The notation => means "is defined as." The braces indicate 
that one of the enclosed expressions must be chosen. 


line (current page assumed) 
position => /page (first line on page assumed) 
line/page 


3.4 RANGES OF LINE NUMBERS 


A range of line numbers can be formed in two ways.1 One way is to 
specify a starting position and an ending position; separate the two 
positions with a colon (:). For example, the following command tells 
SOS to print all lines from line 100 on page 4 through line 500 on 
page 5, inclusive. 


XP LO0/4 2500/5 


Depending on how the lines are numbered, this command could tell sos 
to print five lines, or 50, or none. If you know exactly how many 
lines you want to print, but not what all their numbers are, you can 
form a line-number range using the exclamation point (!) to indicate a 
relative number of lines. The following command tells SOS to print 
Six consecutive lines, starting with line number 100 on page 4. 


KP LOO/S4ATS 


This command prints six lines whether or not it encounters a _ page 
boundary. 


The end points of a range need not themselves be existing line 
numbers. For instance, in a file whose lines are numbered by 10s, the 
range 33:67 refers to the three lines numbered 40, 50, and 60. 


A range can consist of only a single line: you can omit the ending 
position or relative number of lines. Previous examples showed how 
the Print command, which takes a range as its argument, can print a 
single line. 


A command whose range is /page applies to all lines on the page. 


1 A third, much less common way to form ranges is described in 
Section 7.2. 
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You can omit the starting position of a range; SOS defaults’ the 
starting position to the current line, as shown below. 


position (range is a single line) 
( position : position 

range => position !on 

| position (range starts at current line) 

ton (range starts at current line) 


3.5 SHORTHAND CHARACTERS 


SOS recognizes three characters as shorthand for special line numbers. 
These shorthand characters can be used in position specifications to 
stand for both line numbers and page numbers: 


« (period) The current line 
Yee The current page 

(caret or up-arrow) The first line on a page 
Ge The first page in the file 
* (asterisk) The last line on a page 
/* The last page in the file 


The character *, ASCII 94, is represented as a caret on some terminals 
and as an up-arrow on others, 

The character 0 can be used interchangeably with ~ to represent the 
first line on a page or the first page in a file. A line or page 
number of 0 is illegal, and SOS interprets 0 in a position 
specification to mean *. 


Some examples of the use of these shorthand characters follow. 
XF 100%. Print all lines from line 100 


through the current line, 
inclusive. 


XE" 3620. Print all lines from the beginning 
of the page through line 620. 

xP. 110 Print 10 lines beginning with the 
current line. 

KP 3 Print all lines on the current 
page. 

xF/ Same as above: print all lines on 
the current page. 

XP OK 12 Print the last line on the current 
page and the first line on the next 
page. 
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3.6 THE CURRENT POSITION 


The current position in SOS is the position of the last line referred 
to by a command.1l 


For example, after SOS completes a Print or List command, the current 
position is that of the last line that was output. After a Copy or 
Transfer, it is the last line moved. After a Find or Substitute, it 
is the last line matched. (These commands, arranged alphabetically, 
are described in Chapter 5.) Immediately after SOS is initiated, the 
current position corresponds to the first line in the file. 


The current-line pointer is not moved if a command fails for any 
reason and returns an error message, 


Two Edit-mode commands allow you to interrogate and to reset S0OS's 
current-line pointer. To find out where the current line is without 
printing it, use the Give Parameter command =. (described in Section 
5.20). For example: 


Ke, 
+ IS AT 0045075 
x 


The Move Position command (see Section 5.19) resets the current line. 
Its argument is a position specification, which can contain a line 
number, a page number, or their shorthand equivalents. For example, 
the following command moves the current-line pointer to the last line 
on page 3. 


KK/S 
x 


3.7 DEFAULTS FOR LINE AND PAGE NUMBERS 
One form for a complete range specification is: 
linel/pagel:line2/page2 
You can omit various parts of the complete specification, and SOS will 
supply defaults for the omitted parts. The defaults discussed in this 
section apply only to ranges for which: 
e You explicitly type a colon (:) 
e You explicitly type an exclamation mark (!) 


e You use the form /page 


If none of these conditions holds, then the range involves a_e single 
line, and the defaults listed in Section 3.3 apply. 


These defaults apply to all commands when you omit part of a = range 
specification. For some commands, the entire range specification is 
optional. The default range that results depends on the command. See 
the individual command descriptions in Chapter 5 for details. 


1 the terms "current position" and “current line" are used 
interchangeably. In fact, the current position is made up of two 
components, the current line number and the current page number. 
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The following partial range specifications all represent legal ways to 
indicate a range. 

1. linel/pagel:line2 

2. linel:line2/page2 

3. /pagel:line2 

4. linel:/page2 

5. /pagel 

6. :line2 


Below are the complete specifications of the partial ranges listed 
above. The defaults SOS supplies are underlined. 


1. linel/pagel:line2/pagel 

2. linel/.:line2/page2 

3. “/pagel:line2/pagel 

4. linel/.:*/page2 

5. “*/pagel:*/pagel 

6. ./-:line2/. 
Table 3-1 shows the rules SOS uses to supply the omitted parts of a 
range specification. Note that linel defaults to ~* if pagel is 
supplied; but if neither is supplied, the starting position defaults 
to ./. (the current position). If omitted, page2 defaults to pagel, 


if pagel is given; if neither is given, both default to the current 
page. 


Table 3-1 
Defaults for Line and Page Numbers 


If this part is omitted: Its default is: 


linel (if pagel is supplied) 
(if pagel is defaulted) 


/pagel 


line2 
/pagel (whether pagel is sup- 
plied or defaulted) 





Applying the rules given in Table 3-1 in some common cases gives these 
results: 


e A command with an argument of /page acts on all lines on the 
given page. 


@ A command with an argument of :line/page acts on all lines 
between the current position and the given position. 


e A command with an argument of :/page acts on all lines between 
the current line and the last line on the given page. 
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The examples below illustrate SOS's defaults for omitted parts of a 
range specification. 


Complete 
Command Equivalent Meaning 

XF. 280 F.7.280/, Print all lines from the current 
line through line 80 on the current 
page. 

XF/, POS SKS. Print all lines on the current page. 

KEOS DK PCS. SKS 4 Same as above: print all lines’ on 
the current page. 

ee 4 POS. EK Same as above: print all lines. on 
the current page. 

¥FI9O05/3 Pos. t90S/3 Print all lines from the current 


line through line 905, page 3. 


3.8 LINE-NUMBER AND PAGE~NUMBER OFFSETS 


Anywhere that a line number is legal, so is an arithmetic expression 
forming a line-number offset. You can use arithmetic expressions to 
refer to lines whose numbers you do not know. Expressions with a plus 
sign (+) refer to lines later in the file, and those with a minus sign 
(-) refer to earlier lines. 


Arithmetic expressions do not act across page boundaries, unlike the 
exclamation mark construction (relative number of lines). Thus, if 
the current line is the third line from the end of a page, the command 
P.+4 prints the last line on the page (as do P.+5, P.+6, and so on). 


Some examples of line-number offsets follow. 


KP ne Print the line two lines 
before the current line. 


KPC 34 Print all lines from the 
fourth line on the current 
page through the current line. 


KPR-GLLO Print the last six lines on 
the current page and the first 
four lines on the next page. 


KP yo Lt et] Print three lines centered 
about the current line. 


XP .-113 Same as above: print three 
lines centered about the 
current line. 


XPC-3 Print the first line. Note 
that arithmetic expressions do 
not cross page boundaries. 
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Page-number offsets are analogous to line number offsets: anywhere 
that a page number is legal, so is an arithmetic expression forming a 
page-number offset. Some examples follow. 


KF LOO/ +1 Print line 100 on the next 
page. 

KP SO5/K~114 Print four lines starting with 
line 305 on the next-to-last 
page. 

KP/en1/ 641 Print all text from the first 


line onthe previous page 
through the last line on the 
following page. ~ 


You are allowed only one plus or minus sign in an arithmetic 
expression. Thus, P10+3 is legal, but P10+3+1 is illegal. 


The syntax of line numbers and page numbers can now be formally 
defined. In the definitions below, 1, m, p, and q are positive 
integers, and represent the following: 


1 is a line number less than 65536. 
m is a line-number offset. 

p is a page number. 

q is a page-number offset. 


A line number can consist of a number 1 or one of the three’ shorthand 
characters, optionally followed by an arithmetic expression. A page 
number has an analogous form. That is: 


1 


a 


Pp 
line=> [+ m] page=> i [+ q] 
* 


* 


where the braces indicate that one of the enclosed expressions must be 
chosen. 


3.9 HOW SOS NUMBERS NEW LINES 


Basically, when you insert new lines of text into a file, SOS numbers 
each new line by adding the current line-number increment to the 
previous line number. This section discusses three topics’ that 
elaborate on this basic rule: 


e What the current line-number increment is, and how it is set 


@ How SOS behaves when an existing line intervenes before the 
next line number it wants to assign 


e Differences in SOS's line-numbering, depending on whether you 
are entering lines in Input mode or in Alter/insert mode 
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3.9.1 The Current Line-Number Increment 


The current line-number increment is a parameter that SOS maintains. 
If you do not set it, SOS uses a value of 100 for the increment. You 
can find out what its value is by giving the Give Parameter command 
=INCREMENT, and you can set it directly with the Set Parameter command 
/ INCREMENT: n. 


The usual way to change the line-number increment however, is by 
specifying a second argument to an Input or Replace command. With 
this second argument you can call for either a permanent update to the 
increment or a temporary update that applies for this command only. 
Alternatively, you can request SOS to calculate a line-number 
increment that allows a known number of lines to fit in the space 
available to them. See the description of the Input command, Section 
5.7, for details. 


3.9.2 When an Existing Line Intervenes 


SOS does not let you insert lines so that the line numbers would be 
out of sequence. If an existing line stands in the way of the series 
of new line numbers that SOS is generating, the editor eventually 
refuses to accept any more inserted lines since it cannot number them 
in sequence. 


For example, suppose the current line-number increment is 100. You 
want to insert some new text after line 400; however, line 500 already 
exists. You type an Input command: 1400. SOS bends its usual rule 
(which would call for the new line to be numbered 500) and assigns the 
number 450, halfway in between the existing lines. SOS then accepts 
one input line. The next line number SOS calculates, however, is 550 
(the increment, 100, plus the previous line number, 450). Again, this 
line number is beyond an existing line. At this point, SOS returns 
you to Edit mode, ending text insertion. 


3.9.3 Input Mode versus Alter/Insert Mode 


There are two ways in SOS to insert new lines of text: Input mode 
(accessed by the Input or Replace commands) and Alter/insert mode 
(accessed from Alter mode by the command I, or from Edit mode by the 
eXtend command). SOS behaves differently in the two modes when it 
encounters an existing line whose number intervenes in the sequence of 
new line numbers SOS is generating. 


The difference is as follows. In Input mode, SOS lets you insert one 
line before an intervening line, if it is the first inserted line. If 
SOS encounters an intervening line after you have inserted one or more 
lines, it immediately terminates Input mode. In Alter/insert mode, 
upon encountering an intervening line, SOS always numbers the next 
line halfway between the previous line and the intervening line. 


For example, suppose you want to insert text after line 100. The 
current increment is 100, and the next existing line is 500. If you 
enter Input mode to insert the text (I100), SOS numbers the new lines 
200, 300, and 400; then SOS returns you to Edit mode. 
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However, if you enter the new lines in Alter/insert mode (A100, 
followed by I, followed by <LF> for each new line), SOS numbers the 
new lines 200, 300, 400, 450, 475, 487, 493, 496, 498, and 499, At 
this point, no room is left for any more new lines, since the previous 
line and the intervening line are numbered 1 apart. sos rings’ the 
terminal's bell and rejects further line insertion, but leaves you in 
Alter/insert mode, 


If you have more lines to insert, you must return to Edit mode (type 
<RET>) and issue a reNumber (N) command. 


Figure 3-1 shows the logic of SOS's line numbering. In this figure, 
IN is the current line-number increment; NL is the number of the new 
line; PL is the number of the previous line; IL is the number of a 
line that intervenes in the sequence of line numbers SOS is 
generating. In the calculation of a line number halfway between PL 
and IL, the notation {[-1] means that SOS subtracts 1 if IL - PL is 
odd, but does not subtract 1 if IL - PL is even. 


NL=PL+IN 








yes 


no (Alter/insert mode) 
Input mode ? 
yes 


First 
inserted 
line ? 














Ring bell, refuse 
insert. Remain in 
Alter/insert mode. 











NL =PL+ 
(IL-PL)/2 
[-1] 







NL =PL+ 
(IL~PL)/2 
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Return 
immediately to 
Edit mode 






Figure 3-1 How SOS Calculates the Numbers of New, Inserted Lines 


CHAPTER 4 


USING SOS 


The following sections describe default conditions when SOS is invoked 
and give guidelines for using SOS. 


4.1 DEFAULT CONDITIONS WHEN SOS IS INITIATED 


The default conditions that apply to various SOS parameters and 
switches when you start up the editor are listed below. The SOS 
parameters and switches are described fully in Chapter 6 along with a 
way (the symbol-assignment mechanism) to override these initial 
defaults. 


Noexpert -- SOS starts by assuming that you are not an experienced SoS 
user. Therefore, it prints long, self-explanatory error messages; it 
asks for verification before deleting large blocks of text; and it 
displays deleted characters in Alter mode. All examples in this 
chapter assume a nonexpert user. See Section 6.2 for a discussion of 
the EXPERT switch. 


Line numbering -- SOS numbers lines by 100s initially, starting at 
100. When you insert lines of text, SOS uses a line-number increment 
of 100. 


Automatic file saving -- The two parameters that govern automatic file 
saving (see Sections 4.3.3 and 6.1) are initially set to 0; therefore, 
SOS does not automatically save a copy of your file as you work on it. 
You must issue Save World commands to achieve file backup. 


Lowercase characters -- Initially, SOS accepts lowercase characters as 
typed. If your terminal can generate lowercase characters, and if you 
have instructed VAX/VMS not to convert them to uppercase (using the 
DCL command SET), then SOS accepts and echoes them as lowercase. 


4.2 LIMITATIONS AND RESTRICTIONS 
Some limitations and restrictions on the use of SOS are listed below. 


Line length -- No line of text can be longer than 500 characters, 
including spaces but excluding the <RET> that terminates the line. If 
you attempt to generate a line longer than 500 characters (with the 
Alter, Input, Join, Substitute, or eXtend commands), SOS prints the 
error message LINE IS TOO LONG, and returns you to Edit mode. In _ the 
case of an Alter or eXtend command, any changes that you made 
previously to the line are discarded, and you are returned to Edit 
mode. 
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String length -- No string used in a Find or Substitute command can 
exceed 200 characters in length. If you use the forms of these 
commands that allow multiple strings, the combined length of all such 
strings cannot exceed 200 characters. If you exceed these limits, SOS 
prints the error message SEARCH STRINGS EXCEEDED BUFFER LENGTH and 
returns you to Edit mode. Reissue the command with fewer or shorter 
strings. 


Line numbers -- Line numbers cannot exceed 65535 (decimal). 


4.3 USING SOS SAFELY 


Some risk is associated with the use of any text editor. You can, by 
mistake, delete or garble large amounts of text, or even whole files. 
A hardware or software failure that occurs while you are using a_ text 
editor can destroy a considerable amount of work. 


SOS is designed for safe use. The editor assumes that you can make 
mistakes; therefore (unless you have declared yourself an expert SOS 
user, via the EXPERT switch), SOS asks you to confirm certain commands 
that would delete large amounts of text. It also provides features 
that you can use to minimize the adverse effects of system 
malfunctions. 


4.3.1 Built-in Safety Features 


SOS requests confirmation before making major changes to a file. 
Decide mode is one safety feature of SOS; the editor lets you decide 
case by case on character-string substitutions, instead of simply 
making all substitutions. (Section 5.15.3 describes Decide mode.) 


SOS also requests confirmation before performing a Replace or Delete 
that would delete all the text on one page, or would delete across a 
page boundary. 


4.3.2 The Save World Command 


The SOS Save World (W) command saves “everything in the world." [It 
creates a back-up file that is a copy of the input file containing the 
results of all the editing changes you have made so far. 


The W command should be used frequently, perhaps every five or ten 
minutes in a long editing session. In this way you protect yourself 
against the ill effects of system failures, and against any possible 
errors of your own. If some system failure does occur, you lose only 
the work done since the last W command. See Section 5.17 for more 
details on the Save World command. To understand how SOS handles 
files, refer to Chapter 8. 


4.3.3 Two Options for Automatic File Saving 


For even greater safety, you can set two SOS parameters that govern 
the automatic use of the Save World command. These parameters are 
named SAVE and ISAVE. SAVE controls automatic file saving in Edit 
mode; ISAVE controls it in Input mode. 
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To select these options, use the Set Parameter command, slash (/) (see 
Section 5.21). For example: 


*X/SAVE310 
xX/ISAVE TS 
x 


SOS automatically performs a Save World command after you have issued 
ten Edit-mode commands that modify the file, or after you have 
inserted five lines of text in Input mode, whichever comes’ first. 
While executing the save, SOS displays this message: 


NOING AUTO-SAVE., PLEASE WAIT. 


You can set or reset the SAVE and ISAVE parameters at any time while 
SOS is operating in Edit mode. Setting either parameter to a value of 
zero turns off the corresponding auto-save option. When you initiate 
SOS, both options are turned off. 


4.3.4 Recovering Information from Temporary Files: An Example 


If SOS execution is interrupted by a system malfunction, you may be 
able to recover some lost work from SOS temporary files. These files, 
and the way in which SOS uses them, are described in Chapter 8. 
Briefly, one or both of the files SOScnn.TM1 and SOScnn.TM2 may 
contain part of your file (c is the controller number, and nn is the 
number of your terminal). 


The following example illustrates one way in which lost work might be 
recovered from an SOS temporary file. A hypothetical user, Adams, is 
updating a master address list on terminal number 22 when the system 
loses power. Not being prudent by nature, Mr. Adams has not been 
using the W command frequently. After this close call, however, he 
sets the ISAVE parameter for automatic file saving. 


KX=mame 

NALS CAVAMSIAIMRESS .MST317 

x 

Kflarkin ESO) 

FAGE 4 

01050 Larkin ARMAS 4935 Forbes Av. Pittsburgh FA 15213 
KieeS 

01085 Lawson Adam 335 Grand Av. Oak lari CA 94610 


Lav €0 TALIC CIRLIO) GIRLY) 


Nothing works: the system has expired. Several minutes later, after 
Adams logs’ back onto the revitalized system, he recovers information 
from an SOS temporary file as shown below. The temporary file must be 
renamed, because SOS refuses to open a file it recognizes as a 
temporary file. 


USING SOS 


$ VIRECTORY/SIZE SOSA22 6k 


Virectors .OBALICAIAMSI 


SOSAL2.TMLIL 4 
SOSAL2 TM2F1 2 


Total of 2 filesy 6 blocks. 

$ RENAME SOSA22.TM1 ATM .MST 
$ EDIT AUOTME. MST 

EQIT J OBAL SC ADAMSIADUTME MST #1 


¥K/isaveisS 
Xflarkin €0 


FAGE 4, 
01050 Larkin ABINES 49335 Forbes Av. Fattshurgh PA 15213 
Kies Ss 


oT 


AW address. mst 
COURAL S CADAMS JADURESS .MST#183 
x 


The exact details of the editing done so far determine how current the 
material contained in an SOS temporary file will be. Adams was lucky; 
most of the previously edited material was in the temporary file. 


However, the point of emphasis here is that you cannot depend on SOS 
temporary files to provide reliable back-up in case of system failure. 
Such files are at best a last resort. The safest back-up is frequent 
use of the W command. 


CHAPTER 5 


EDIT-MODE COMMANDS 


This chapter describes in detail the forms and functions of SOS 
Edit-mode commands. The commands are presented in alphabetical order. 
The four nonalphabetic commands (.= /@) are given last. The 
functions of <RET> and <ESC>, when they are used as Edit-mode 
commands, are discussed along with the Print command. 


Table 5-1 summarizes the commands, their syntax, and the pages. on 
which they are described. The remainder of this introduction defines 
the terms used both in the table and in the rest of this chapter. 


EDIT-MODE COMMANDS 


Definitions for the Edit-Mode Command Summary (Table 5-1) 

Uppercase letters represent literals that you type verbatim, (sos 
accepts either upper- or lowercase letters.) Lowercase terms, represent 
variables, defined below. The symbol => means “is defined as." 
Brackets ([ ]) indicate optional parts of the argument string (except 
in directory or file-spec, in which one set of brackets must be 
typed). Stacked braces ({ }) mean choose one of the enclosed 
expressions. Angle-brackets (< >) enclose descriptive terms, and 
<ESC> represents the escape key (or ALTmode, SELect, or PREfix). 
file-spec => [device:][([directory]]filename[.type[;version] ] 

increment => <a positive integer line-number increment> 


1 => <a line number> (0 < 1 < 65536) 


line => : [+ m] 
* 
m => <an integer line-number offset> 
n => <a positive integer> 
Pp => <a page number> 
( P 
page => [+ q] 
* 


parameter => <a legal SOS parameter or switch> 


position => ) line [/page] 
/page 


q => <an integer page-number offset> 


sposition 
position 
!n 


:position 


range => 


In 
start => <a positive integer line number> 
string => stringl({ @ string2[ @) string3[ @ string4 


[ string5[ string6]]]]] (fewer than 200 
characters) 
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Table 5-1 
Edit-Mode Command Summary 


Alter! 
Copy? 


Delete 
End 
Overwrite input file 
No output file 
Strip line numbers 
No numbers, no pages 
Find? 
Help 
Input* 


Join 
Kill page mark 
List:LP or file 


Mark 
reNumber 
Print: terminal 
Replace* 


Substitute® 

Transfer 

Save World 

eXtend® 

Move Position 

Give Parameter 

Set Parameter 

Execute Command File 
Print next line 

Print previous line 


‘Enter Alter mode. 


? Enter Copy-file mode (if /C). 


3 Enter Alter mode (if ,A). 


Arguments 


[range] 

position [=file-spec] ,range[,incrementl [,increment2] ] 
position=file-spec/C 

[range] 

[B] [Q] [S} [T] [:file-spec] 


ea kee LA] [.N] LE] Ln] 
nh 


[position] [,increment] 
[position] [;increment] 
[position] [;!n] 

[position] 

/page 

[range[,S] [,P[:file-spec] ] ] 
[range] [,[S] [,F:file-spec] ] 
[position] 

[increment] [, [range] [,start]} ] 
[range] [,S] 

[range] [,increment] 

[range] [;increment] 

[range] {;!n] 
[[oldstring@esc_)newstring] Cesc) [range] [,D] [,N] [,E] ] 
position,range[,increment1 [,increment2] ] 
[B] [:file-spec] 

[range] [.N] 

position 

parameter 

parameter [:n] 

file-spec 





4 Enter Input mode. 
5 Enter Decide mode (if ,D). 
6 Enter Alter/insert mode. 
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A 
Alter 


5.1 ALTER (A -- ALTER MODE) 
Format: 

A[range] 
Argument: 


range 
Specifies the range of lines to be edited one at a time in Alter 
mode. If you omit range, only the current line is edited. 


Current line: 


After SOS completes an Alter command, it sets the current line to. the 
last line edited. 


The Alter command invokes Alter mode, a special intraline editing 
mode, for each line in turn in the given range. Alter mode is useful 
for making changes within a line without having to retype it. It is 
also useful for making changes involving the column positions of 
characters in a single line or within a range of lines. 


For each line in the given range, SOS prints the line number and waits 
in Alter mode for your input. Eighteen commands are legal in Alter 
mode; any other input is ignored and rings a bell on the terminal. 
These commands are listed in Table 5-2 and described fully later in 
this section. The single-character commands are not echoed when 
typed. Instead, they are effected immediately. 


SOS maintains an intraline pointer in Alter mode. At any given time 
this pointer points between two characters in the line. You can space 
the pointer across the line a character or a word at a time (forward 
or backward); you can insert text before or after the pointer 
position; and you can delete or replace one or more characters before 
or after the pointer. 


Alter mode displays a line of text differently depending upon the kind 
of terminal you use. 


On hard copy terminals, SOS displays characters that the pointer 
passes aS you move across the line. When you move the pointer 
backwards across the line (to the left), characters are displayed in 
reverse order and are surrounded by backslashes (\...\). Any 
characters you delete are displayed between pairs of backslashes 
(\\.ee N\A) (Note that, if you have declared yourself an expert SOS 
user by typing the command /EXPERT, deleted text is not echoed. See 
Section 6.2 for a description of the EXPERT switch.) 


On video display terminals, when you move the pointer to the left, SOS 
erases any characters that the pointer passes. Characters deleted to 
the left of the pointer are erased; characters deleted to the right 
of the pointer are delimited by double backslashes (unless you have 
specified /EXPERT). 


The following sections describe Alter mode editing on hard copy 
terminals, and the examples display Alter mode editing as it appears 
on hard copy devices. The difference between hard copy and video 
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display is also true for the other Edit mode commands. Descriptions 
and examples given for these commands refer to hard copy editing. 


As shown in Table 5-2, many Alter-mode commands can be preceded by a 
positive or negative integer. For most commands, the result is to 
repeat the command the given number of times. The repetition count 
does not make sense for some commands, and is ignored. Positive 
repetition counts move the pointer to the right, and negative counts 
move it to the left (except for <DEL>, for which the reverse is true). 


Table 5-2 
Alter-Mode Commands 


Meaning 


[-] [n]Cx... 








Do not print rest of line; recycle to 
beginning of line with edits incorporated, 


Change next/previous n characters to given 
characters.1 


{[-] [n]D Delete next/previous n characters. 


E End Alter mode for this line; do not print 
line. 
[-] [n] Itext & Insert text after/before pointer; use 


temporary increment n for new lines. 
(n]J Split line after pointer; use increment hn 
for new lines. 

{-] [n] Kx Kill (delete) all until nth occurrence of 
character x. 


Print rest of line; recycle to beginning 
of line with edits incorporated. 


Print rest of line; recycle to current 
position with edits incorporated, 


Q Quit Alter mode; restore original line. 


{-] [n}] Rtext &9 Replace next/previous n characters with 


inserted text. 


(-] {n) Sx Skip forward/back to nth occurrence of 
character x. 


{[-] [n]w 
[-] [n] X 
[-} [n]* 





1 "Next" if no minus sign is typed; 


typed. 


Skip forward/back n words. 
Delete next/previous n words. 


Invert case of next/previous n characters. 








"previous" if minus sign is 


The other commands that accept a minus sign are presented 
in similar fashion. 


(continued on next page) 
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Table 5-2 (Cont.) 
Alter-Mode Commands 











Meaning 


commana | 


[-][n}< 

























Convert next/previous n characters to 


uppercase, 


Convert next/previous n characters to 
lowercase. 


Space back/forward n characters. 


GED Leave Alter mode for this line; print rest 
of line. 


[-] [n] @ Space back/forward n characters. 


Leave Alter mode for this line; print rest 
of line. 


[-] [n] & Space forward/back n characters. 









[-] TAB Skip to end/start of line. 


GRU) Do not print rest of line; recycle to 
current position with edits incorporated. 

CIAL) Start fresh: discard edits, recycle to 
beginning of line, do not print line. 





Figure 5-1 shows on five lines the interactive process of using 
Alter-mode commands to edit a single line of text. (On your terminal, 
you would see the single line displayed piece by piece as you gave the 
commands.) User input is shown in color. Alter-mode commands are not 
echoed as typed; rather, SOS displays their results on the text line. 
The arrow (1) shows the position of the intraline pointer at the time 
the user types the given Alter-mode commands. The resulting printout 
is shown immediately below each arrow; an underline ( ) marks the new 
position of the intraline pointer. The five Alter-modé commands used 
in the figure are described more fully later in this section. 


If the range specified for an Alter command is empty, SOS prints’ the 
error message RANGE GIVEN DOES NOT CONTAIN ANY LINES. 
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Commands used in this example are: 


W moves the pointer to the right past one word and its 
following space(s) and/or tab(s). 


inserts the text you type until <ESC> (in the example, 
the text is active<SP>). 


moves the pointer to the right one character at a time, 
and prints the character. 


changes the following character to the next character 
you type (in the example, q). 


prints the rest of the line and ends Alter mode for 
this line. SOS returns to Edit mode, because the Alter 
command applies to only one line in the example. 


user reauiring CFU time obtains 


iactive €s0 


active . ; 
ee 


active user re... 
caw 


active user reauiring .. 
RET 


active user reauiring CFU time obtains 





Figure 5-1 Alter-Mode Example 


B (Alter mode) 


B Do not print rest of line; recycle to beginning of line 


The B command tells SOS to recycle to the beginning of the line. That 
is, the line number is reprinted and the pointer is positioned before 
the first character. All edits made to the line up to this point are 
incorporated. SOS does not print the remainder of the line (from the 
current pointer position to the end) before recycling. 
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C (Alter mode) 


(-][n]Cx... Change next/previous n characters to given characters 


SOS accepts and prints the next n characters typed on the terminal. 
These characters replace the n characters in the line immediately to 
the right of the pointer. The pointer moves one character to the 
right as you type each character. If you type a minus sign before C, 
the n characters you type replace text to the left of the pointer 
position. SOS displays two backslashes (\\) followed by the replaced 
characters (in reverse order). When you type the first replacement 
character, Sos displays two more backslashes and echoes’ each 
replacement character as typed. The following example illustrates 
this sequence. 


Ke ry 
00908 The preliminsty business elan Cattached) 
Ka. 
wW 
} . 
90905 The ereliminsty 


“4c 


00905 The erelimingsty \N ywts.. 
ary GB 


00905 The vrelimingsty \N\ yte\\N\ary .. 
RED) 
} 


00905 The ereliminsty \\ gts\Naery business elan Cattached) 
x 


The C command is ignored if the pointer is at the end of the line (or 
at the beginning of the line for -n). 


Three characters prematurely terminate the C command: <ESC>, <RET>, 
and <LF>. If you type nC, followed by some replacement characters 
(fewer than n), followed by one of these three characters, SOS 
terminates the C command. 

e After <ESC> or <LF>, SOS is at command level in Alter mode. 


e After <RET>, SOS continues with the next line in the range of 
the Alter command, or returns to Edit mode if none remain. 


In each case, n characters have been deleted from the original text 
line, 


The character <DEL> is ignored after a C command. 
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D (Alter mode) 


[-][n]D Delete next/previous n characters 


Typing D deletes the character that follows the pointer. More than 
one character is deleted if you precede the D command with a number. 


On hard copy terminals, the deleted character(s) is (are) displayed, 
surrounded by pairs of backslashes: \\abc\\.. On video display 
terminals, characters deleted to the left of the pointer are simply 
erased; characters deleted to the right of the pointer are enclosed 
in double backslashes. (See the Alter mode command for an explanation 
of the difference between hard copy and video terminal editing.) If 
you supply a number, n, that is greater than the number of characters 
remaining in the line, all remaining characters are deleted. If you 
precede the command with a minus sign, characters before the pointer 
are deleted. The D command is ignored if the pointer is at the end of 
the line (or at the beginning of the line for -n). 


E (Alter mode) 


E End Alter mode for this line; do not print line 


The E command tells SOS to end Alter mode for this line. The rest of 
the line is not printed. If more lines remain in the range you 
specified when issuing the Alter command, SOS proceeds in Alter mode. 
Otherwise, the Edit mode prompt (*) is issued. (The <RET> command is 
the usual way to exit from Alter mode; <RET> prints the rest of the 
line before returning to Edit mode, or to the next line in the range.) 


1 (Alter mode) 


[-] [n]Itext 60 Insert text after/before pointer; use temporary 
increment n for new lines 


The I command moves SOS to Alter/insert mode. SOS accepts characters 
from the terminal and inserts them into the line beginning after the 
current pointer position. If you precede the command with a minus 
sign, characters are inserted before the pointer position. 
Alter/insert mode is terminated when you type <ESC>; the editor is 
left in Alter mode. The pointer is then positioned to the right of 
the inserted text, and points to the same place it did before the 
insertion. The inserted characters are echoed on the terminal as 
typed. 


Both Alter/insert mode and Alter mode are terminated for this line if 
you type <RET>. In this case the final <ESC> is not needed. SOS 
prints the rest of the line and returns to Edit mode (or continues in 
Alter mode if more lines remain). 
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If you type <DEL> while inserting text, the previous character is 
deleted. <DEL> echoeS as a pair of backslashes followed by the 
deleted character. Successive <DEL>s delete and echo previous 
characters in turn. The next non<DEL> character that you type is 
echoed as a second pair of backslashes followed by the character. If 
you type more <DEL>s than the number of characters you have inserted 
with the I command, SOS continues deleting characters to the left of 
the original point of insertion (until it encounters the beginning of 
the line). SOS remains in Alter/insert mode, 


If you insert so much text that the overall length of the line exceeds 
500 characters, SOS prints the message LINE IS TOO LONG and returns 
you to Edit mode. Any changes that you may have made to the line up 
to this point are discarded. 


You can type a number before the I command. This number is not a 
repetition count, as it is for most Alter-mode commands. Instead, it 
acts as a temporary line-number increment if SOS creates a new line 
while inserting text. SOS creates a new line when you split an 
existing line by inserting <LF>. If you type a negative number, -n, 
before the I command, SOS uses +n as the temporary increment and 
inserts characters before the pointer position. If you type <LF> 
while in Alter/insert mode, SOS creates a new line to receive the rest 
of the inserted text. The number of this new line is determined as 
follows: 


® If you type a number before the I command, this number is 
taken as a temporary increment and is added to the current 
line number. 


e I£ you do not type a number before the I command, the current 
increment is added to the current line number. 


e If an existing line intervenes between the current line number 
and this new number, the new line is numbered halfway in 
between. 


e If the next existing line is numbered 1 higher than the 
current line, a bell sounds and no new line is created. 


After the new line is created, the pointer is positioned at the 
beginning of the new line; SOS is still in Alter/insert mode. 


In Alter/insert mode, any character you type (with seven exceptions) 
is inserted into the text line. Many control characters do not have 
their usual effect when entered in Alter/insert mode. For example, 
<CTRL/S> and <CTRL/Q> have no effect on terminal output. They are 
simply inserted into the text line without interpretation, 


The following seven characters are not treated as text,in Alter/insert 
mode. 


ends insertion. 

ends Alter mode for this line. 
deletes the previous character. 
creates a new text line. 
returns SOS to Edit mode. 
retypes the line. 

gets the attention of DCL. 


BgAcese 


EDIT-MODE COMMANDS 


J (Alter mode) 


[n]J Split line after pointer; use increment n for new lines 


The J command in Alter mode performs the same function as <LF> in 
Alter/insert mode. When you type J at the pointer position, SOS 
creates a new line and moves text appearing to the right of the 
pointer onto this new line. 


The procedure for determining line numbers of new lines is the same 
for both the J command and <LF> in Alter/insert mode. See the section 
on Insert (Alter mode) for a description of this procedure. 


After the new line is created, the pointer is positioned at the 
beginning of the line; SOS is still in alter mode. SOS displays the 
text on the new line when you exit from Alter mode by typing <RET>. 
For an explanation of how to join lines, see Section 5.8. 


K (Alter mode) 


[-] [n] Kx Kill (delete) all until nth occurrence of character x 


This command tells SOS to delete all text from the pointer position up 
to, but not including, the next occurrence of the given character x. 
If you supply n, SOS deletes all text up to the nth occurrence of x. 
A minus sign causes SOS to delete backwards (to the left) from the 
pointer position through the given character. Deleted characters are 
printed within pairs of backslashes (in reverse order for -n). 


SOS ignores the K command if the given character does not occur in the 
remainder of the line, or if it occurs fewer than n times. 


If the EXACT switch is on (See Section 6.2), SOS requires an exact 
upper- and lowercase match with the given character x. 


L (Alter mode) 


L Print rest of line; recycle to beginning of line 


This command tells SOS to print the rest of the line, from the pointer 
position onward, and recycle to the beginning of the line. The line 
number is reprinted and the pointer is positioned before the first 
character. All edits made to the line up to this point are 
incorporated. Compare the L command with the P command, described 
next (and see the following example). 
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P (Alter mode) 


P Print rest of line; recycle to current position 


The P command tells SOS to print the rest of the line, from the 
pointer position onward, and recycle to the current pointer position. 
All previous edits are incorporated. The P command lets you get a 
fresh look at a line you are editing. The example below shows the P 
command and the L command. 


Ky 
002490 while the muon sees 3 cross section of O42 barnsy 
K3o 

wwii 


t 
00240 while the .. 
eri GED secondary 
¢ 
00240 while the rri\NireN\\secondary .. 
wi" €0 
t 
00240 while the rriNNireN\\secondary muon “ 
fe 


t 
00240 while the eriN\N\ire\\secondary muon “sees @ cross section 
of 0.2 barnsys 
00240 while the secondary muon " 
40 i" @ 1 





4 

00240 while the secondary muon “sees* a cross section of 0.2 b 
arnsy 
00240 = 

iMean GO 5S @ iy @ @e 

4 
00240 Meanwhiley 
Xr, 


00240 Meanwhile, the secondary muon "sees" a cross section of 
0.2 bharnse 


Q (Alter mode) 


Q Quit Alter mode; restore original line 


The Q command immediately returns you to Edit mode. Thus it differs 
from the E and <RET> commands, which end Alter mode only for the 
current line. Q returns you to Edit mode even if more lines remain in 
the range you specified in the initial Alter command. 


Under most circumstances, Q restores the line to its original state 
(as it was before editing with the Alter command). Any changes you 
made to the line are discarded. However, if you have formed new lines 
by inserting <LF>, the Q command leaves them intact. 
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R (Alter mode) 


{[-](n]Rtext © Replace next/previous n characters with inserted 
text 


The R command behaves exactly like the command [-][(n]D followed by the 
command OItext<ESC>. SOS deletes the next n characters after the 
pointer (before the pointer for -n) and enters Alter/insert mode. The 
characters deleted are displayed surrounded by pairs of backslashes 
(in reverse order for -n). (If the EXPERT switch is on, SOS does not 
display deleted text.) If you type <LF> after an nR command to create 
a new line, SOS does not use the given n to determine the new line 
number. In other words, the n in nR applies to the delete operation, 
not to the insert operation. 


S (Alter mode) 


{-] [n]Sx Skip forward/back to nth occurrence of character x 


The S command accepts one character from the terminal, without echoing 
it, and moves’ the pointer to the right until the next occurrence of 
that character. If you supply n, the pointer moves to the nth 
occurrence of the character.- The pointer moves to the left past the 
skip character if n is negative. All characters that the pointer 
moves over are printed. If the pointer moves to the left, the 
intervening characters are printed in reverse order between single 
backslashes. 


The character after the current pointer position is not compared to 
the skip character. Therefore, you can skip through a line by 
repeatedly typing, for example, Se. The pointer is advanced each time 
to the next occurrence of e. 


If the EXACT switch is on (see Section 6.2), the § command 
distinguishes between uppercase and lowercase skip characters. For 
example: 


K/exact 
Xe 1é0 ; 
00140 Frocuetion manager Arm Shraft eroJects deficits of 
KB, 

GB 


00160 Froduction mm. 
5A 
4 


001490 Froduction manager .. 


The S command is ignored if the given character does not occur in the 
rest of the line, or if it occurs fewer than n times. The pointer is 
not moved. 
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W (Alter mode) 


[-][n}W Skip forward/back n words 


This command moves the pointer to the right (to the left for -n) until 
it points to the first character of the next word. The pointer moves 
over spaces and tabs, then over the next word, then over any following 
spaces and tabs. If you supply n, the pointer moves to the start of 
the nth following word (preceding for -n). 


A "word" is defined as any collection of letters and numbers. 


X (Alter mode) 


{-] [n]X Delete next/previous n words 


The X command acts like the W command, except that it deletes spaces, 
word(s), and following spaces through the nth word after the pointer 
(before the pointer for -n). SOS prints deleted characters between 
pairs of backslashes (in reverse order for -n). (If the EXPERT switch 
is on, SOS does not print deleted characters.) 


Typing 99X is an easy way to delete the rest of a line. 


*“ (Alter mode) 


[-]{n]* Invert case of next/previous n characters 


This command changes the case of n characters after the pointer 
(before the pointer for -n). Uppercase letters become lowercase, and 
lowercase characters become uppercase. Nonalphabetic characters are 
not affected. The cursor moves past the n characters and they are 
echoed (for -n, the characters are echoed in reverse order between 
backslashes). 


< (Alter mode) 


[-] [n]< Convert next/previous n characters to uppercase 


This command converts uppercase characters to lowercase. The pointer 
Moves past n characters (or moves back n characters if -n). All 
lowercase characters encountered become uppercase; and uppercase 
characters encountered are not affected. The n characters are echoed 
(for -n, in reverse order between backslashes). 
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> (Alter mode) 


{[-]{n]> Convert next/previous n characters to lowercase 


This command converts lowercase characters to uppercase. The pointer 
Moves past n characters (or moves’ back n characters if -n). All 
uppercase characters encountered become lowercase; any lowercase 
characters encountered are not affected. The n characters are echoed 
(for -n, in reverse order between backsSlashes). 


(5) (Alter mode) 


[-] [n] Space back/forward n characters 


Typing <BS> moves the intraline pointer one space to the left. The 
characters that the pointer passes over are printed between single 
backslashes. If you supply n, the pointer moves back n_ characters. 
The pointer moves forward if n is negative: -n<BS> is exactly 
equivalent to n<SP>. If the n (or -n) you supply is greater than the 
number of characters remaining, the pointer moves to the beginning 
(end) of the line. SOS ignores the command if the pointer is at the 
beginning of the line (or at the end of the line for -n). 


(Alter mode) 


@) Leave Alter mode for this line; print rest of line 


This Alter-mode command is the usual way to terminate editing for the 
current line. <RET> ends Alter mode for this line whether you are in 
Alter mode or in Alter/insert mode. SOS prints the rest of the line, 
and either prints the line number of the next line in the range or 
gives the Edit-mode prompt if no lines remain. 


(Alter mode) 


{-][n] @0) Space back/forward n characters 


<DEL> has the same effect as <BS>: it moves the character pointer one 
Space to the left. <DEL> does not delete characters at Alter-mode 
command level, it simply moves the pointer. The characters that’ the 
pointer passes over are printed between single backslashes. 


If you supply n, the pointer moves back n_ characters. Pointer 
Movement is to the right if n is negative: -n<DEL> is exactly 
equivalent to n<SP>. If the n (or -n) you supply is greater than’ the 
number of characters remaining, the pointer moves to the beginning 
(end) of the line. SOS ignores the command if the pointer is at the 
beginning of the line (or at the end of the line for -n). 
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(Alter mode) 


() Leave Alter mode for this line ; print rest of line 


<LF> acts like <RET> to end Alter mode for this line, if SOS is at 
Alter-mode command level. From within Alter/insert mode, however, 
<LF> signals SOS to create a new line. See the Alter-mode command I, 
above, for details. 


(Alter mode) 


[-] [n] Space forward/back n characters 


Typing <SP> moves the pointer one character to the right and prints 
the character. The pointer moves n characters if you supply n. 
Pointer movement is to the left if n is negative; characters are 
printed in reverse order between single backslashes. If the n (or -n) 
you supply is greater than the number of characters remaining, the 
pointer moves to the end (beginning) of the line. SOS ignores the 
<SP> command if the pointer is at the end of the line (or at _ the 
beginning of the line for -n). 


(Alter mode) 


[-] fs Skip to end/start of line 


<TAB> (or <CTRL/I>) moves the pointer to the end of the line and 
prints characters that the pointer passes over. If you type a minus 
sign, SOS moves the pointer to the start of the line and prints 
characters in reverse order between single backslashes. 


The Edit-mode command xX (eXtend), which invokes Alter mode, is 
equivalent to the command A_ followed by <TAB> and I. That is, X 
prints the line and invokes Alter/insert mode at the end of the line. 


(Alter mode) 


GA Do not print rest of line; recycle to beginning 


The <CTRL/R> command tells SOS to recycle to the current pointer 
position. All previous edits are incorporated. SOS does not print 
the remainder of the line (from the current pointer poSition to. the 
end) before recycling. Thus, in Alter mode CTRL/R> behaves the same 
as in Edit mode. 


B~14 
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(Alter mode) 


TRL) Start fresh: discard edits, recycle to beginning of line, do 
not print line 


This command restarts Alter mode for the current line. Any previous 
changes you made are discarded. SOS immediately redisplays the line 
number without printing the rest of the line. 


If you have formed new lines by inserting <LF>, the <CTRL/U> command 
leaves previous lines intact, It discards any changes made to the 
latest <LF>-created line and recycles to the beginning of that line. 


<CTRL/U> does not have the same effect in Alter/insert mode. In this 
mode, <CTRL/U> is taken as text and is inserted into the line. 
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Cc 
Copy 


5.2 COPY (C) 
Formats: 


Cposition,range[,incrementl[,increment2] ] 
Cposition=file-spec[,range[,incrementl[,increment2]]] 
Cposition=file-spec/C 


Arguments: 


position 
Specifies the destination for the copied lines. If the line 
number specified by position already exists, the copied lines are 
inserted after position. If not, the copied lines are inserted 
beginning at position. 


range 
Specifies the source range of the lines to be copied. To specify 
a range, type the line numbers that delimit the range, separated 
by a colon (:). I£ you omit range in the second form, above, the 
entire file is copied. 


incrementl 
Specifies the line-number increment for SOS to use for the copied 
lines. If the source range contains page marks, incrementl is 


used only up to the first page mark. If you omit incrementl, SOS 
uses the current line-number increment. 


increment2 
Specifies the line-number increment for SOS to use for the lines 
following the final page mark in the source range. If you omit 
increment2, SOS uses the current line-number increment. 


Signals that text is to come from a second file (the copy file). 


file-spec 
Specifies the copy file. 


Option: 


7c 
Tells SOS to enter Copy-file mode: that is, to open the copy file 
as a read-only file so that you can search it for the text to be 
copied. 


Current line: 


After SOS completes a Copy command, it sets the current line to the 
last line copied. 


The Copy command inserts a copy of a block of text at a given position 
in the file. The block of text can be copied either from somewhere 
else within the file (the first usage form above) or from another file 
(the second and third usage forms). In the latter case, if you type 
/C at- the end of the Copy command, SOS enters Copy-file mode so you 
can locate the text in the second file. 
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When you give a Copy command, SOS acts as if you had given an Input 
command at the given location, and treats each text line in the 
specified range as if you had typed it in. 


SOS takes steps to make sure that line numbers are in proper sequence 
after a Copy operation. The rest of this section gives details on 
line numbers before and after a Copy command. For an example of how 
SOS handles line numbers in this situation, see Section 5.15, Figure 
5-2. 


SOS chooses a small enough line-number increment to allow all the 
lines in the range to fit after the destination position, using the 
following protocol: 


1. SOS checks whether all the lines will fit if it uses the 
current line-number increment. 


2. If the lines will not fit with the current’ line-number 
increment, SOS checks whether the lines will fit if it uses 
the increment you supply (incrementl). 


3. If the lines will not fit with incrementl (or if you have not 
supplied incrementl), SOS tries to find a smaller increment 
that will make the lines fit. 


SOS cannot choose a small enough increment if the number of lines’ to 
be copied is larger than the numerical difference between the line 
number at position and the number of the next line in the file. In 
this case, SOS inserts page marks. First, it copies as many lines as 
will fit, using either the current increment or your incrementl (if 
supplied), inserts a page mark, and copies the rest of the source 
lines with their line numbers intact. Then SOS inserts a second page 
mark. 


SOS tells you what increment it has used with the message INCl=n. If 
it inserts a page mark, SOS issues the message INC1=ORDER n AND P/M 
INSERTED. 


If the range of lines to be copied already contains page marks, SOS 
renumbers the copied lines only up to the first page mark. The page 
mark is copied, and all the lines up to the last page mark in _ the 
range are copied with their line numbers intact. 


For the lines after the last page mark, SOS follows a protocol similar 
to the one it uses for lines before the first page mark: 


1. If the lines will fit, SOS copies them using the default 
line-number increment. 


2. If the lines will not fit with the default line-number 
increment, SOS uses the increment you specify (increment2). 


3. If the lines will not fit with increment2 (or if you have not 
supplied increment2), SOS chooses a smaller increment. 


If SOS cannot choose a small enough increment, it inserts another page 
mark, copies the lines with numbers intact, and inserts a final page 
mark. 


If the source range contains page marks, SOS tells you the increment 
it uses for the lines copied after the final page mark. The message 
is INC2=n if SOS does not have to insert a final page mark, and 
INC2=ORDER n AND P/M INSERTED if it does insert one. 
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If the specification of the source range contains the shorthand symbol 
*, meaning the first line on a page, SOS copies the page mark that 
precedes the first line before it begins to copy the text. If the 
range specification contains *, meaning the last line, SOS copies the 
following page mark as well. 


Note that SOS copies the page mark(s) whether you specify the 
symbol(s) * and/or *, or whether SOS supplies them as defaults. Thus, 
SOS copies the preceding page mark if you type the range 


S/3BT50/4 


This is because the initial line number for page 3 defaults to *. SOS 
copies the succeeding page mark if you type the range 


2O/SSE7A 


This is because the final line number for page 4 defaults to *. If 
you type only a single page number for the range, SOS copies both the 
preceding and the succeeding page marks for that page. For example: 


43 


This is because SOS expands /5 to */5:%*/5. 


5.2.1 Copy-file Mode 


This mode allows you not only to copy a block of text from another 
file, but also to search the copy file to locate the text. You call 
for Copy-file mode by using the Copy command in the third format given 
in Section 5.2. For example: 


XC455/3=CONTROL .OLB/C 


The equal sign (=) means that text is to be copied from a second file, 
and the final /c signals Copy~file mode. If you do not type /C (that 
is, if you use the second uSage form given above), the entire file is 
copied at the point specified. In this example, the file would be 
copied at or after line 455, page 3, depending on whether or not line 
455 exists. 


If you type the final /C, SOS prompts C* and waits for you to type a 
Find, Print, List, or Move Position command. Only a limited number of 
commands are legal in Copy-file mode because the copy file is 
read-only while it is open. The Edit-mode commands <RET> and <ESC> 
are legal, because they are essentially abbreviations of the Print 
command. Also legal, but of limited utility, are Give Parameter, Set 
Parameter, and Command File. Any other command results in the message 
COMMAND INVALID FOR READ ONLY FILE. 


After you locate the desired lines in the copy file, type 
CxXE 
SOS responds with 
ENTER RANGE OF LINES? 
At this point you complete the Copy command with the range and, if 
desired, one or two line-number increments. You can use line-number 


abbreviations (.%”* * ) in specifying the range. The values of the 
current line, current page, last line, and so forth refer to the copy 
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file, not to the original file. If you type <RET> at the "ENTER RANGE 
OF LINES" prompt, SOS copies the entire file. SOS completes the copy 
operation and responds with * (the Edit-mode prompt). 


If, after scanning the file, you decide that you do not want to copy 
any lines, type: 


CXEQ 
If you decide to cancel the copy-file command at the "ENTER RANGE OF 


LINES" prompt, type <CTRL/C>. In both these cases, SOS returns to 
Edit mode without copying any part of the file. 
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D 
Delete 


5.3 DELETE (D) 

Format: 
D[range} 

Argument: 


range 
Specifies the lines to be deleted. If you omit the range, the 
default is to delete the current line. 


Current line: 


After SOS completes a Delete command, it sets the current line to the 
last line deleted (which no longer exists). 


This command deletes the lines in the specified range. If no lines 
are in the range, SOS prints the error message RANGE GIVEN DOES NOT 
CONTAIN ANY LINES. 


Before deleting all lines on a page, or deleting across a page 
boundary, SOS requests confirmation with one of the following 
questions: 


DELETE ENTIRE FAGE? Y OR N3 
DELETE ACROSS PAGES? Y OR N;3 


SOS then waits for you to type either Y or N (a <RET> is not needed). 
SOS rejects any character other than Y, y, N, or n and repeats the 
question. 


After deleting the lines, SOS reports the results of the deletion with 
a message such as the following: 


81 LINE(S) DELETED (00145/2300250/4). 
x 


If the EXPERT switch is on, SOS neither requests confirmation nor 
tells you how many lines were deleted. 


SOS automatically renumbers the remaining pages of the file if you 
delete an entire page. 
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End 


5.4 END (E) 
Formats: 


E[:file-spec] 

EB(:file~-spec] 
EQ{:file-spec] 
ES(:file-spec] 
ET[:file-spec] 


Arguments: 
file-spec 


If given, specifies the output file. If omitted, SOS uses’ the 
current output file specification. 


B 
Tells SOS not to create a "back-up" file. The output file has 
the same version number as the input file, and the input file is 
effectively deleted. 

Q 
Tells SOS to quit without writing an output file. 

Ss 
Tells SOS to write the output file without line numbers, but with 
page marks. 

T 


Tells SOS to write the output file without line numbers or page 
marks. 


Current line: 
Not applicable: after the End command, SOS terminates. 


The End command terminates the editing session and returns you to DCL. 
Different arguments combined with the End command modify the way SOS 
exits from a file. 


SOS tells you the specification of the output file it writes. It 
gives no specification if you exit without an output file (EQ). If 
you have not changed the file since it was last written, SOS appends 
the note (NO CHANGES) to the file specification, and exits without 
rewriting the output file. If you do not give a file specification 
with the E command, SOS writes an output file with the same file 
specification as given in the last Save World command. If no Save 
World was given, then the file name and type are the same as those of 
the input file, but the version number is higher by 1. If you supply 
a file specification, the output file is written with that 
specification. 


When supplying a file specification, you cannot make SOS write its 
output file over an existing file. If a file already exists with the 
Same name and type as the given file specification, SOS increments the 
version number before writing the output file. If the given file 
specification is identical to that of an existing file, including the 
version number, SOS rejects the command with the message FILE ALREADY 
EXISTS and requests a new filename with the prompt ENTER NEW 
FILENAME:. 
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Use the B argument with the End command to request SOS not to create a 
back-up file when it exits. The version number of the output file is 
not incremented. Thus, the information in the original file is lost, 
unless you have previously given a Save World command that incremented 
the version number. 


Adding the S argument to the E command requests SOS to write the 
output file without line numbers. You can use ES to save disk space, 
since files without line numbers require less storage space. However, 
SOS requires significantly more processing time to generate a file 
without line numbers. This is because of the way SOS handles 
temporary files; see Section 8.1. 


On VAX/VMS systems, you need not use ES to make allowances’ for 
programs that cannot deal with Jline-numbered files. (This is 
desirable on some other systems with other implementations of SOS.) On 
VAX/VMS, the input/output system transparently handles line-numbered 
files. Therefore, the use of ES should be rare. 


Use the T argument with the End command to clean up a file that has 
become messy with uneven line numbers and with page marks scattered 
randomly throughout. ET tells SOS to write the output file as a 
textual file, without page marks as well as without line numbers. The 
next time SOS opens the file, it renumbers it. You can use the 
symbol-assignment mechanism to control SOS's line-numbering defaults 
(see Section 6.3). Thus, you can start fresh with the file. 


One use of the ET form of the End command is in preparing command 
files to serve as command input to SLP, the batch-oriented editor (see 
the VAX-1l Utilities Reference Manual for a detailed description of 
SLP). You can also use ET to prepare a file for reading by a program 
that does not recognize line numbers and page marks. 


If you type E without an argument (B, Q, S$ and/or 1), SOS exits, 
creates both back-up and output files, and writes line numbers and 
page marks to the output file. 


You can use any combination of the B, S, and T options with the End 
command, in any order. Some useful forms are given below. 


ESB Write the output file without line numbers. Do not 
increment its version number. 


ERT Write the output file without line numbers or page 
marks. Do not increment its version number. 
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5.5 FIND (F) 
Formats: 
F[{string] @ [range][,A][(,N][,E][,n][,-]] 


F[{stringl 


string6] @ [range] [{,Al]l,N][,E][,n1] 
Arguments: 


string 
Specifies the string of characters (fewer than 200) that SOS is 
to search for. SOS prints the first line in which the string is 
found. If you omit string, SOS uses the current find string. 


range 
Specifies the range of lines to be searched. If you omit range, 
SOS searches from the line after the current line to the end of 
the file, 


stringl...string6 
Specifies six or fewer distinct strings that SOS is to _ search 
for. The total number of characters in the strings may not 
exceed 200. 


Options: 


A 

f 
Tells SOS to enter Alter mode automatically when the string is 
found. The intraline pointer points before the beginning of the 
string in the line. 


N 

r 
Tells SOS to print only the line number(s) of the _ line(s) in 
which the string is found. 

rE 
Tells SOS not to treat uppercase and lowercase letters as 
equivalent in the search string. 

mn 


Tells SOS to find the next n occurrences of the string in the 
given range. 
Tells SOS to print the next line that does not contain string. 
Current line: 
After SOS completes a Find command, it sets the current line to the 


last line found; however, if the search fails, the current line is 
unchanged. 
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Common short forms: 


F 
Search for the string(s) specified in the previous complete Find 
command, starting at the line after the current line, and 
continuing to the end of the previously specified range. 

F  €s 


Search for the previously specified string(s), starting after the 
current line and continuing until the end of the file. 


Use the Find command to find a given string of text occurring within a 
given range of lines. SOS prints the first line containing the string 
within the range. If the range includes more than one page, and _  SsO0S 
finds the string on a page other than the current one, it prints PAGE 
n. before printing the line containing the string. If SOS cannot 
find the string in the given range, it prints STRING NOT FOUND, SEARCH 
FAILED. The current line is unchanged. 


To find the first occurrence of a word on a given page, use _ the 
following form: 


*Fisomer 44 


This form of the command means find and print the first line on page 4 
that contains the string "isomer". 


To locate the next occurrence of the same string you gave in the 
previous Find command, use only the range argument: 


xF G0 /6 


This form means find and print the first line on page 6 that contains 
the string "isomer" (from the previous Find command). If you use this 
form of the Find command before you issue a complete Find command, SOs 
prints ILLEGAL SEARCH STRING GIVEN. 


If you omit the range specification, SOS begins searching at the line 
following the current line, and continues through the end of the file. 
For example: 


kKfdeoxyribo 


This form means find the first occurrence of the string "deoxyribo" 
beginning with the line following the current line through the end of 
the file. 


You can give the Find command repeatedly, each time finding the next 
occurrence of a string in the file. To do this, simply type F. For 
example: 


*frandom /13/% 
00320 but random rerturbations of the lattice structure 


xT 
01310 4 certain degree of randomness in the rrocess. 
xf 
FAGE 2. 
00110 2 rseudo-random number in the interval COrLlIJ» chosen 
xf 
STRING NOT FOUND, SEARCH FATLED 
Kx, 
+ IS AT 0011072 
x 
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You can search for as many as six different strings at once by using a 
special form of the Find command. Instead of typing <ESC> after the 
first string, type <RET>; SOS prompts you with F* for another search 
String. After typing all the search strings in this way, type <ESC> 
and the range and options (if desired). 


The multiple search strings can contain up to 200 characters in all. 


An example using two search strings is given below. Note that the 
user has typed ,99 as an option at the end of the Find command. SOS 
finds the first 99 (or fewer) occurrences of either search string in 
the range. 


Kfrandom 

FxXstochastic SLESKIOP 

00320 but random rerturbations of the lattice structure 
00769 from the stochastic eauation (Ea. 4-2), 

01310 @ certain degree of randomness in the rrocess,. 


PAGE 2. 
00110 @ reseudorandom rmumber im the interval COrsiJy chosen 


FAGE 4. 
O1210 in the study of stochastic rrocesses,. 
x 


A common error in using the Find command is to type <RET> after a 
search string when you meant to type <ESC>. SOS assumes you intend to 
specify multiple search strings, and prompts F*. At this point, you 
can type <ESC> and complete the Find command normally. 


5.5.1 Find Options 


“The complete Find command, including options, is shown as the first 
format given at the beginning of Section 5.5. You can supply options 
in any combination and in any order. 


If you give a Find command with one or more options, these options 
will still be in effect if you later use the abbreviated form F. The 
7n option is an exception: it applies only to the complete Find 
command. 


To reset the options while still using an abbreviated Find command, 
type F<ESC>. 


If you do not use the ,E option, the command below would 
indiscriminately find a line containing any of the following: number, 
Number, or NUMBER. 


Xfrnumber 


This ambiguity can be useful: for example, when you want to find a 
word whether it begins a sentence or not. But if you want SOS to 
distinguish uppercase from lowercase characters when searching, use 
the ,E option, 


Using the ,E option is equivalent to turning on the EXACT switch (see 
Section 6.2) for Find commands only. 


Use a large number like 999 for the ,n option to find all the strings 
in a given range. Unlike the other three options, the ,n option 
applies only to one execution of the Find command. For example, if 
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you give the command FFIRST<ESC>,2 and later use F, SOS finds only one 
more occurrence of the string FIRST. 


If you use the ,A (Alter mode) and ,- (do not find) options in the 
same Find command, SOS enters Alter mode with the intraline pointer 
positioned at the beginning of the line that was found. 


Examples: 
Xfdidi €0 %/4ser3 


Print the first three lines, from the current line through’ the 
last line on page 4, that contain the string digi. Do not match 
a string unless its case (upper or lower) agrees exactly with 
that of the given string. 


xf 


Print the next line after the current line that contains the 
string digi. The search starts at the line after the current 
line and continues to the end of the range last specified (to the 
end of page 4). An exact pattern match is still required. Sos 
prints only one matched line; the ,3 option specified in the 
previous Find command applies only to that one command. 


Kf EO t/Kyriv99D 


Print only the line numbers (and page numbers) of the lines in 
the rest of the file that contain the string digi. Exact pattern 
matching is no longer called for. Consequently, SOS matches Digi 
and DIGI, for example, as well as digi. 


k=string 
FINI- 

digi 
SUBSTITUTE- 
FOR x 


Display the strings currently in effect for the Find and 
Substitute commands. See Sections 6.1 and 5.20, respectively, 
for details on the STRING parameter and the Give Parameter 
command (=). 


xXfMunich 
FaBorr 
FxBerlin GO ..3/Kvaver999 


Find all occurrences of any of the strings Munich, Bonn, and 
Berlin in the rest of the file. Do not match a string unless it 
Starts with an uppercase letter. As each string is found, enter 
Alter mode for that line, with the intraline pointer positioned 
before the start of the string that was found. 
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Help 


5.6 HELP (H) 
Format: 
H{sn] 
Argument: 
n 
Specifies the number of the module in the help package that sos 
is to start printing. 
Current line: 
The Help command does not affect the current line. 
The Help command prints a help package on your terminal. This package 
is composed of a number of modules, A control feature lets you skim 
quickly through the modules. 
After the introductory module, the help package contains summaries of 
SOS features and functions similar to Appendix A, but formatted for 
printing on a terminal. 
If you type the Help command with no argument, SOS prints the entire 
help package. The introductory module contains a list of the other 
modules and their numbers, plus instructions for printing the help 
package on the line printer, 
If you type <CTRL/O> while a module is printing, SOS skips to the 
beginning of the next module, You can skim through the help package 
by typing successive <CTRL/O>S. Typing <CTRL/C> returns you 
immediately to Edit mode. 


If you type the Help command with an argument n, SOS prints module 
number n and continues to the end of the help package. 


AS an example of how you can use the Help command, suppose you want to 
see a list of Alter-mode commands. Proceed as follows: 


1. Type H. SOS prints the introductory module. 


2. Type <CTRL/C> when you read that module number 6 summarizes 
Alter-mode commands. SOS prints the Edit-mode prompt *. 


3. Type H:6. SOS prints module number 6, 


4. Type <CTRL/C> when SOS begins to print module number 7. SOs 
prompts with *, 
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I 
Input 


5.7 INPUT (I -- INPUT MODE) 
Formats: 


I({position] {,increment] 
I[position] [; increment] 
I[position] [;!n] 


Arguments: 


position 

Specifies the destination for the inserted text; position is the 
line number of the first inserted line, if a line does not 
already exist at position. If a line exists at position, the 
line number is set to position plus the current line~number 
increment (or the specified increment). If another line exists 
at or before this new line number, the new line is numbered 
halfway in between. If you omit the position argument, insertion 
continues at the position where the last Input command left off. 


increment 
Specifies the new current line-number increment, if preceded by a 
comma. If preceded by a semicolon, the argument is a temporary 
increment only for this insert. If you omit increment, the 
current line-number increment is used. 


Specifies the number of lines you want to insert. SOS calculates 
an appropriate temporary line-number increment. 
Current line: 


After SOS completes an Input command, it sets the current line to the 
last line inserted. 


Common short forms: 


I. 
Insert after the current line. 

[* 
Insert after the last line on this page. 

I/*+1] 
Start a new page at the end of the file and begin inserting 
there. 

I 
Continue inserting after the line most recently inserted, using 
the line-number increment given in the last complete Input 
command. You must issue a complete Input command before using 
this form. 

Use the Input command to enter new lines into a file. Its arguments 


are a single position (line/page) and/or a line=-number increment. 
Text insertion begins (SOS enters Input mode) at or after the line 
number specified by position. SOS accepts successive lines of text 
from the terminal, and inserts them into the file. Successive line 
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numbers are determined by adding the current increment to the previous 
line number. 


The increment argument, if specified with a comma, becomes’ the new 
line-number increment. If specified with a semicolon, increment acts 
as the line-number increment for this command only. Subsequent 
commands continue to use the default increment (except I without any 
arguments, which uses the temporary increment). 


Use the third form of the Input command when you know exactly how many 
lines you want to insert. In this case, SOS calculates a line-number 
increment that allows the given number of lines to fit before the next 
existing line. 


You can move directly from Input mode to Alter mode by using a special 
sequence of characters: <CTRL/A> followed by <ESC>. When you type 
this sequence, SOS switches to Alter mode and positions the pointer at 
the beginning of the last line you inserted while in Input mode. 
(Note that the <ESC> character is echoed when you type this special 
sequence.) Now you can use any of the Alter mode commands to correct 
the line. 


When you exit from Alter mode (by typing <RET> or E), SOS returns you 
to Input mode if, when you left it, you still had a range of lines for 
input. SOS gives the line-number prompt just as if you had stayed in 
Input mode and typed <RET> at the end of the line. However, if there 
were no more empty lines when you entered Alter mode from Input mode, 
SOS returns you to Edit mode. 


Exit from Input mode by typing <ESC>. If you type <ESC> at the 
beginning of a new input line, that (empty) line is not inserted into 
the file. The last full line inserted becomes the current line. You 
can also return to Edit mode by typing <ESC> at the end of the last 
line to be inserted. 


In some circumstances, SOS returns you to Edit mode automatically. 
These circumstances are given below, along with ways to recover and 
continue inserting text: 


e A line exists whose number is equal to or less than the number 
that SOS calculates for the next inserted line, and this line 
is not the first line inserted. (To continue inserting text, 
issue another Input command, specifying a smaller increment.) 


e The line number that SOS calculates for the next inserted line 
is greater than 65535. (Renumber part of the file.) 


@e You try to insert a line longer than 500 characters. (Use 
shorter lines.) 


After completing an Input command, when you have returned to Edit 
mode, SOS remembers the line number and page number of the next line 
to be inserted. If you type I, text insertion resumes at this point. 
soS uses the increment specified in the last complete Input command 
you typed, even if it was a temporary increment. Thus, in this 
special case, the temporary increment endures after the Input command 
in which it was established. 


If you specify an existing line as position in an Input command, and 
this line is followed by another line with a number higher by 1, SOS 
prints the error message INSUFFICIENT LINE NUMBERS FOR INSERTION. In 
this case, use the reNumber command (N), and then reissue the Input 
command. 


53> 3h 


Example: 


xP 12 
00130 
00140 
KIer2 
00142 
00144 


00146 
4 (RED) 
00150 
xI 
00146 
k= BIG 
4 
KIK/ 4 
00430 
00432 
KE 


MOV 
CLR 


BEQ 
MOV 


MOV 


BNE 
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RS» CNTBL (RS) §SAVE UCB POINTER 
U.CW2CRS) sCLEAR ALL SWITCHES 

10% ¢IF EQUAL YES 

T.TCBCRI) RO sGET REQUESTOR TCR ADDRESS 


170,sU.CNTCRS) §SET COUNT FOR 170 NULLS 
65% sIF NE. DON’T FUNCH TRAILER ESC 


VERSION 21A» 2-21-78. GNL. 


ESC) 


COBALS CLANEYIFPIRV.MACI184 


$ 
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5.8 JOIN (J) 

Format: 
J{position] 

Argument: 


position 
Specifies the line to be joined to the following line. If you 
omit position, the current line is joined to the following line. 


Current line: 


After SOS completes a Join command, it sets the current line to. the 
new line made from the two old lines; that is, the current line number 
becomes the specified position. 


The Join command joins two lines together. The joined line is given 
the number of the first line of the pair, that is, of the line at the 
specified position. It becomes the current line after the Join 
command completes, The line number that previously belonged to the 
second line of the pair ceases to exist. 


SOS refuses to join two lines if the resulting line would be longer 
than 500 characters. It prints the error message LINE IS TOO LONG. 


If the line specified by position is the last line on a page, SOS 
prints ILLEGAL SYNTAX OF COMMAND. 


Example: 


Ke 40013 
00400 The doal is always 


FAGE 2. 

00610 to write clearr unambiguous 

00650 functional srecifications that are easy to understand, 
*J400/1 

ILLEGAL SYNTAX OF COMMAND 
Kk/2 
* 5400 
xr, 
00400 The soal is glwaysto write clears unambiguous 
Kae 

s56 @ i @® 8 @e@ 


00400 The dosl is always 

ee 

00400 The goal is always to write clear, wnambisuous 
* 
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K 
Kill Page Mark 


5.9 KILL PAGE MARK (K) 
Format: 

K/page 
Argument: 


/page 
Specifies the page mark to be deleted. 


Current line: 
The Kill Page Mark command does not affect the current line. 


This command deletes ("kills") a page mark that you have inserted with 
the Mark command, or that SOS has inserted in the course of a Copy or 
Transfer command. When a page mark is deleted, the text that was 
previously on that page appears at the end of the preceding page. (A 
page mark is considered to be located at the head of its page.) 


You can delete only one page mark at a time. 


Deleting a page mark can leave line numbers out of order. sos warns 
you with the message LINES OUT OF ORDER. In this case, you must 
immediately renumber the current page using the reNumber command. 


If you try to delete a nonexistent page number, SOS prints the message 
PAGE DOES NOT EXIST. If you try to delete page mark 1 (K/1), SOS 
responds CANNOT KILL INITIAL PAGE MARK. (SOS considers the text 
immediately after the start of the file to be on page 1, but it does 
not insert a physical page mark there.) 
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5.10 LIST (L) 
Formats: 


L{range][,[(S][,P{=file-spec]]] 
L{range][,(S][,F=file-spec}] 


Argument: 


range 
Specifies the range of lines to list. If you omit range, SOS 
lists the entire file. 


Options: 


S 
’ 
Tells SOS to suppress line numbers in the listing. 


»P:file-spec 
Tells SOS to produce a disk file, with the given file 
specification, formatted for later printing. 


,F:file-spec 
Tells SOS to produce a disk file formatted as an ordinary SOS 
text file. 


Current line: 


After SOS completes a List command, it sets the current line to the 
last line listed. 


The List command allows you to generate either a printer listing or a 
disk file containing all or part of the file being edited. The List 
command has an advantage over the DCL PRINT command for printing SOS 
files. The List command generates headings on each page of printer 
output giving the SOS page number, as well as each listing page's 
sequential number within the SOS page. 


The heading contains the specification of the file being listed; the 
date and time printed; and a page number in the form m-n, where m 
represents the page number in the SOS file, and n is the sequential 
number of the listing page within the SOS page. (When n=1, the 
printing of "-n" is suppressed.). These headings are generated if you 
specify ,P (whether the output goes to a printer or to a disk file). 
The headings are also generated if neither ,P nor ,F is specified. 


The SOS parameter LENGTH controls the page length of listings produced 
by the List command, ,P option. Its initial value is 55 lines. You 
can reset this parameter if desired (see Section 6.1). 


You can specify a particular printer by using the ,P option in the 
form ,P:LPcen (c is the controller designation and n is the printer 
number). LPcn is a legal file specification. If you omit file-spec 
from the ,P option, or if you supply neither ,P nor ,F, the listing is 
sent to LPAO. 


The option ,F:file-spec generates a disk file containing the lines in 
the given range, but without the page headings described above. The 
disk file thus produced is a normal SOS file. Any page marks in the 
range are included in the file. The ,S option, if present, tells SoS 
to suppress line numbers in the disk file. 


5-35 
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M 
Mark 


5.11 MARK (M) 

Format: 
M[position] 

Argument: 

position 
Specifies the position (line/page) that is to be the first line 
on a new page. SOS inserts a page mark before the given 
position. If you omit position, the current line is assumed. 


Current line: 


After SOS completes a Mark command, it sets the current line to _ the 
first line on the new page. 


The Mark command inserts a page mark at a specified point in the text 
and renumbers all subsequent pages. 


If the line number in the position specification does not exist, 80S 
inserts the page mark immediately after the previous, lower-numbered 
line. 


If you give the Mark command for the first line on a page, SOS inserts 
a page mark immediately after the existing page mark. The page that 
previously existed is then empty. 


After the completion of a Mark command, the current line is the first 
line on the new page. Therefore, if you give the Mark command shown 
below, the current line becomes 300/4. 

*M300/3 


The new line is the same line that you referred to in the command as 
300/3, but it is now on page 4. 
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N 
reNumber 


5.12 RENUMBER (N) 
Formats 


N[increment] [, [range] [,Start]] 
NA[increment][, [range] [,start]] 
NP[increment][, [range] [,start]] 


Arguments: 


increment 
Specifies the line-number increment between the renumbered lines, 
If you omit it, SOS uses the current line-number increment. 


range 
Specifies the range of lines to renumber. If you omit it, SOS 
renumbers the entire file. 


start 
Specifies the starting line number for the renumbering. If you 
omit it, SOS starts renumbering at the value of increment. 


Tells SOS to add increment to every line number in the given 
range. 


Tells SOS to renumber all lines in the range sequentially. sos 
does not reset the starting line number at each page boundary. 


Current line: 


After SOS completes a reNumber command, it sets the current line to 
the last line renumbered. 


This command renumbers the lines in the given range. You must use 
reNumber whenever SOS prints the message LINES OUT OF ORDER. More 
commonly, you can renumber upon. receiving the error message 
INSUFFICIENT LINE NUMBERS FOR INSERTION (or at any other time). 


The first argument, increment, specifies the increment between line 
numbers. The first line renumbered is given this number, unless you 
specify the third argument (Start). Each succeeding line is given a 
number that is the sum of the increment and the previously assigned 
number. 


If SOS crosses a page mark while renumbering, it assigns the increment 
number to the first line on the new page (unless you specify NP). For 
example, you type the following command: 

KN1O09/23/3 


Before renumbering, the line numbers on pages 2 and 3 might be as 
shown below. 


Page 2 115 126 137 150 
Page 3 900 911 952 1022 


R27 
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After renumbering, the line numbers are; 


Page 2 10 20 30 40 
Page 3 10 20 30 40 


If you use the NP form of the command, SOS does not reset its 
numbering when it encounters a page boundary. The entire range is 
numbered in ascending order. Thus, using NP in the above example 
produces: 


XNP109/23/73 
Page 2 10 20 30 40 
Page 3 50 60 70 80 


The NA form of the reNumber command tells SOS to add the _ specified 
increment to each line number in the range. If you use NA, the start 
argument is meaningless. If supplied, it is ignored. 


If you do not specify a range, SOS renumbers the entire file. If the 
range is empty, SOS prints RANGE GIVEN DOES NOT CONTAIN ANY LINES. 


If, while renumbering, SOS assigns a line number larger than 65535, it 
stops renumbering immediately and prints the message LINE NUMBER STEP 
TOO LARGE - LINES OUT OF ORDER. At this point, you must reissue the 
reNumber command using a smaller increment or a smaller starting 
number. 


If, after issuing a Kill Page Mark (K) command, you get the error 
message LINES OUT OF ORDER, renumber using /. as the range (the 
current page). 
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Print 


5.13 PRINT (P) 

Format: 
P[range] [,S] 

Argument: 

range 
Specifies the range of lines to print. If you omit range, SOS 
prints 16 lines (or the number of lines given by the parameter 
PLINES). 

Option: 


S} 
a 
Tells SOS to suppress line numbers and to print only the text. 


Current line: 


After SOS completes a Print command, it sets the current line to the 
last line printed. 


Common short forms: 


P 
Print 16 lines (or the number of lines given by PLINES) starting 
at the current line; cross page boundaries if necessary. 

P/. 
Print all lines on the current page. 

GED 


Print the next line. 


Print the previous line. 


The Print command prints on your terminal the lines in a given range, 
including line numbers. If the range includes a page boundary, SOS 
prints a blank line and PAGE n. to mark it. 


Use the option ,S to suppress line numbers in the Print command. SOs 
still prints PAGE n. when it crosses a page boundary. 


You can interrupt typeout at any time by typing <CTRL/S>. Output 
pauses until you type <CTRL/Q> to resume where it left off. To 
Suppress all remaining output from a Print command, type <CTRL/O>. 
There may be a slight pause before SOS gives the Edit-mode prompt * 
because SOS continues to move output to a buffer area after you type 
<CTRL/O>. If you type a second <CTRL/O> during this pause, typeout 
resumes at some later point in the output. 
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If you use the Print command without arguments, SOS prints a number of 
lines (initially 16) beginning with the current line. You can change 
the number of lines printed by P by resetting the SOS parameter 
PLINES. The command is: 


x/PLINES ¢ ri 
x 


See Section 5.21 for details on the Set Parameter command /. 


The Edit-mode commands <RET> and <ESC> act as abbreviated forms of the 
Print command. They tell SOS to print, respectively, the next line 
and the previous line in the file. With <RET> and <ESC>, you can step 
through a file a line at a time in either direction. 


<RET> and <ESC> operate regardless of page boundaries. For example, 
suppose the current line is the last line on page 3 when you type 
<RET> s 


oy 


+ IS AT 1600/3 
x GED 


FAGE 4. 
00100 Guidelines for creating RUNOFF files online sre 
x 


These two special abbreviations of the Print command can be defined as 
follows: 


P.+l1 if . #*#* 
<RET> => 

p°/.+1 if . =* 

P.-l if . #*%* 
<ESC> => 

P*/.-l1 if , =” 

Example: 

Keen! 


00330 trade-off involved in usins relatively organized 
00540 files instead of seauerntially organized ones? in 
00545 most cases» retrieval time is raduced sidnmificantly, 
x FED 

00550 Howevers there may be wrused sreace om the file. 

x ED 


FAGE 3. 

00010 Access Methods: 
XK pk 

00660 VAX 11 RMS file organizations listed in Table 4-1. 
x=, 

+ IS AT 0060073 

*=BIG 

3 

* GED 

NO SUCH LINE EXISTS 

x 
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R 
Replace 


5.14 REPLACE (R) 
Formats: 


R[range] [, increment] 
R[range] [; increment] 
R[range] [;!n] 


Arguments: 


range 
Specifies the range of lines to be deleted and replaced with new 
text. SOS enters Input mode, The first new line of text is 
given the number of the first line in the range. If you omit 
range, the current line is replaced. 


increment 
Specifies the new current line increment, if preceded by a comma. 
If preceded by a semicolon, it is a temporary increment for this 
command only. If you omit increment, the current line-number 
increment is used. 


Specifies the number of lines you want to insert in place of the 
deleted range. SOS calculates an appropriate line-number 
increment. 


Current line: 


After SOS completes a Replace command, it sets the current line to the 
last line inserted. 


Common short forms: 


R. 
Replace the current line with a new line or lines typed in. 


Replace the current line. 


The Replace command acts like a Delete command for the given range, 
followed by an Input command at the first line in the range. SOS 
tells you how many lines have been deleted (unless the EXPERT switch 
is on) and then enters Input mode. You can optionally supply an 
increment for the Replace command, as you can for the Input command. 


The increment, if supplied, acts as either a temporary (;) or 
permanent (,) update of the current line-number increment. That is, 
use the ,increment argument to change the default line-number 
increment. Use the ;increment argument to define a temporary 
increment for this command only. Subsequent Input and Replace 
commands continue to use the default increment, 


Use the third form of the Replace command, Rrange;!n, if you know 
exactly how many lines you have to insert. SOS calculates an 
appropriate (temporary) line-number increment. 
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The line number of the first inserted line is that of the first line 
that SOS deleted in the range. Subsequent line numbers are determined 
by adding the current increment to the previous line number. 


If you specify a range that crosses page boundaries, or that includes 
an entire page, SOS asks for confirmation before deleting anything. 
SOS prints one of the following queries: 


DELETE ACROSS PAGES? Y OR N3 
REPLACE ENTIRE PAGE? Y OR N$ 


SOS does not request this confirmation before deleting if the EXPERT 
switch is on. 


In only one particular does the Replace command differ from an 
equivalent combination of Delete and Input commands. The Replace 
command does not define the proper parameters to allow the abbreviated 
Input command I. You can use this abbreviated form only after typing 
a full Input command. 


Examples: 


¥R/2 250 
REPLACE ENTIRE FAGE? Y OR NiY 


Replace all lines on page 2 and insert new lines, beginning with 
the first line deleted. Use an increment of 50; make 50 the 
current line-number increment. 

XR1503 !2 
Replace line 150 on the current page with two lines. sos 
calculates a temporary increment that allows the two lines to 
fit. 

KR337!/55!7 


Replace the five lines starting at line 337 with seven new lines. 
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S 
Substitute 


5.15 SUBSTITUTE (S) 
Formats: 


S[{oldstring €0 newstring] G0 [range][,D][(,N][(,E]] 
Sfoldstringl @& 


oldstringn newstringl G 


newstring @ ][range][,D](,NI[,E] 
Arguments: 


oldstring 
Specifies any string of characters (fewer than 200). 


newstring 
Specifies a string of characters that SOS is to substitute for 
all occurrences of oldstring within the range. 


range 
Specifies the range of lines over which SOS is to make the 
substitution. If you omit range, SOS performs the substitution 
only on the first match found, starting its search with the 
current line, proceeding if necessary to the end of the file. 


oldstringl...oldstringn 
Specifies six or fewer distinct strings that SOS is to replace 
with newstring (1 ton). The total number of characters in all 
the oldstrings cannot exceed 200. 


newstringl...newstringn 
Specifies six or fewer strings that SOS is to substitute for 
oldstring (1 to n). The total number of characters in all the 
newstrings cannot exceed 200. 


Options: 

1D 
Tells SOS to enter Decide mode. 

7N 
Tells SOS to suppress printing out the line(s) in which’ the 
substitution was made. 

rE 


Tells SOS to accept only an exact match (upper- and lowercase 
letters must agree) in the oldstring(s). 


Current line: 
After SOS completes a Substitute command, it sets the current line to 


the last line in which a substitution was made. If SOS does not find 
the string to be replaced, it does not change the current line. 
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Common Short Forms: 


You must issue a complete Substitute command before using these forms. 


Ss 
Perform substitution(s) on one line: the first line containing 
the current oldstring. Search from the current line to the end 
of the current range. 

S €) . 
Perform substitution(s), using the current oldstring and 
newstring, on the current line. 

S €0 


Perform substitution(s), using the current oldstring and 
newstring, on the first line containing oldstring. Search from 
the current line to the end of the file. 


This command substitutes an arbitrary string of characters (newstring) 
for another arbitrary string (oldstring) within a given range of 
lines, and prints each line in which a substitution is made, 


An option (,D) invokes Decide mode, in which SOS displays each line 
for which a substitution is appropriate -- with the change already 
made -- and asks you to decide the disposition of the line. Decide 
mode is described fully in Section 5.15.3. 


SOS remembers the strings you specify in a Substitute command so that 
you can reuse them in a later command. For example: 


Xsloctor Or, 13/2 


This command tells SOS to substitute the string Dr. for all 
occurrences of Dottor on pages 1 and 2. Then, the following command 
tells SOS to make the same substitution on page 3. 


Ks 60 /3 


If you omit the search strings as shown above before you have issued a 
complete Substitute command, SOS prints ILLEGAL SEARCH STRING GIVEN. 


A Substitute command with no arguments (assuming you have already 
issued a complete command) performs the substitution in only one line: 
the next line, starting from the current line, in which oldstring 
occurs. The search proceeds, if necessary, until the end of the range 
specified in the last complete Substitute command. 


One exception applies: if the last Substitute command operated on the 
current line, then S without a position tells SOS to search from the 
line after the current line. Thus, having issued a complete 
Substitute command, you can perform the same substitution one line at 
a time throughout the range by repeatedly typing S and then pressing 
<RET>. 


SOS prints a blank line and PAGE n. each time it makes a substitution 
on a new page, 
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5.15.1 Multiple Substitutions 


SOS can perform substitutions for several string-pairs at a time. 
That is, oldstringl is replaced by newstringl; oldstring2 by 
newstring2; and so on. Use the second usage form above as follows: 


1. Specify all oldstrings first, and follow each oldstring with 
<RET>. 


2. SOS prompts with S* to remind you that you are within the 
Substitute command. 


3. After typing the last oldstring, type <ESC> and the first 
newstring. Follow each newstring with <RET>. SOS prompts 
with S*, 


4. After specifying the last newstring, type a final <ESC>. 


5. Complete the command by typing the range (and options, if 
desired). 


The limit for multiple substitutions is six oldstring-newstring pairs. 
The total length both of all oldstrings, and (independently) of all 
newstrings, cannot exceed 200 characters. 


For example, suppose you want to substitute the variable x6 for all 
occurrences of X in a FORTRAN program, and likewise Y6 for Y. xX and Y 
are always space-delimited. Use the following Substitute command: 


x5 @® XQ 
Sk © YO w @ X46 @ ch 
$x Y4 f13/% 


You can specify fewer newstrings than oldstrings. If you do, sos 
substitutes the last newstring for all the extra oldstrings. For 
example, to substitute the word "Sheep" for all occurrences of "goat" 
and "goats" on page 1, type: 


kssoats 
Skeosat sheer €0 /1 


Note that in the case of two oldstrings, one of which is a leading 
subset of the other, you must give the longer oldstring first. 


5.15.2 Substitute Options 


The substitute options (,D ,N ,E) can appear in any order at the end 
of a substitute command. Any options used in a complete substitute 
command remain in effect for later S commands. 


SOS always distinguishes uppercase from lowercase characters in 
newstring(s). The ,E option only affects SOS's interpretation of 
oldstring(s). 


For example, suppose you want to change the name of the utility 
routine in the following line: 


903390 The utility routine EXE is executed by 
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The following Substitute command effects the change: 


XSEXE G0 XQT G0 330se 
60330 The utility routine XQT is executed by 
x 


The EXACT switch controls this exact pattern-matching feature. If 
EXACT is on, every Substitute (and Find) command requires an exact 
pattern match. When SOS is initiated, EXACT is off. Section 6.2 
describes the EXACT switch. 


5.15.3 Decide Mode 


SOS enters Decide mode if you type the option ,D after the range in a 
Substitute command. (SOS also enters Decide mode if the DECIDE switch 
is on, that is, if you have issued a /DECIDE command.) In this mode 
you can decide on a line-by-line basis whether or not to make each 
substitution. 


SOS prints each line in which it makes a substitution, and prompts 
with D*. Type one of the eight single characters shown in Table 5-3. 
No <RET> is needed. If you type any character other than those 
listed, SOS repeats the prompt. 


Table 5-3 
Decide-Mode Commands 


Meaning 





1 eatin tate nme aman ihre apneneenen eer 















Yes, make the change as_ shown. SOS continues in 
Decide mode with the next line to be changed. 


No, do not make the change. The line remains 
unaltered. SOS continues in Decide mode with the 
next line to be changed. When the range is exceeded, 
SOS returns to Edit mode. 


Alter: enter Decide Alter mode, with the change 
already made. Once in Decide Alter mode, you can 
type any legal Alter-mode commands. When you end 
Decide Alter mode, SOS continues Decide mode by 
displaying the next changed line (if any remains in 
the original range). 


End: do not make the change, and immediately leave 
Decide mode (return to Edit mode). No further 
substitutions are made in the original range. 
Go: yes, make the change, and make all further 
changes in the range automatically, without 
Decide-mode intervention. 

Same as @ : no, do not make the change. 


Quit, same as E: do not make the change, return 
immediately to Edit mode. 


Same as : yes, make the change. 
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T 
Transfer 


5.16 TRANSFER (T) 

Format: 
Tposition, range[,incrementl[,increment2] ] 

Arguments: 

position 
Specifies the destination for the transferred lines. If the line 
number specified by position already exists, the transferred 
lines are inserted after position. If not, the lines are 


inserted beginning at position. 


range 
Specifies the source range of the lines to be transferred. 


incrementl 
Specifies the line-number increment for SOS to use for the 
transferred lines. If the source range contains page marks, 


incrementl is used only up to the first page mark. If you omit 
incrementl, SOS uses the current line-number increment. 


increment2 
Specifies the line-number increment for SOS to use for the lines 
following the final page mark in the source range. If you omit 
increment2, SOS uses the current line-number increment. 


Current line: 


After SOS completes a Transfer command, it sets the current line to 
the last line moved. 


The Transfer command moves a block of text from one place in a file to 
another. When you give a Transfer command, SOS acts as if you had 
given an Input command at the given location, and treats each text 
line in the specified range as if you had typed it in. The text is 
deleted from its original place in the file. Contrast this command 
with the Copy command, which moves a block of text without deleting it 
(see Section 5.2). 


SOS takes steps to make sure that line numbers are in sequence after a 
Transfer operation. The rest of this section gives details on line 
numbers before and after a Transfer command. Figure 5-2 shows an 
example of a Transfer command. 


SOS chooses a small enough line-number increment to allow all_ the 
lines in the range to fit after the destination position, using the 
following protocol: 


1. SOS checks whether all the lines can fit if it uses’ the 
current line-number increment. 


2. If the lines will not fit with the current line-number 
increment, SOS checks whether the lines can fit if it uses 
the increment you supply (incrementl). 


3. If the lines will not fit with incrementl (or if you have not 
supplied incrementl), SOS tries to find a smaller increment 
that can make the lines fit. 


87-S 
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The Transfer command is issued to move part of the file to another location (as indicated 
above by the arrow). The file in this example has as its text, for each line, the correspond- 
ing line number and page number. 


The above shows the origin and destination of each line in the file before and after 
the Transfer command, respectively. SOS’s line numbering would be the sare for 
an equivalent Copy command, except that a copy of the lines would be left in their 
original place (before line 50, page 5). 


Figure 5-2 Transfer Operation to Move 
Part of a File to Another Location 
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SOS cannot choose a small enough increment if the number of lines’ to 
be moved is larger than the numerical difference between the line 
number at position and the number of the next line in the file. In 
this case, SOS inserts page marks. First, it transfers as many lines 
as will fit, using either the current increment or your incrementl (if 
supplied), inserts a page mark, and transfers the rest of the source 
lines with their line numbers intact. Then SOS inserts a second page 
mark, 


SOS tells you what increment it has used with the message INCl=n. If 
it inserts a page mark, the message is INC1=ORDER n AND P/M INSERTED. 


If the range of lines to be transferred already contains page marks, 
SOS renumbers the transferred lines only up to the first page mark. 
The page mark is copied, and all the lines up to the last page mark in 
the range are transferred with their line numbers intact. 


For the lines after the last page mark, SOS follows a protocol similar 
to the one it uses for lines before the first page mark: 


1. SOS moves them using the default line-number increment, if 
they can fit. 


2. If the lines will not fit with the default line number 
increment, SOS uses the increment you specify (increment2). 


3. If the lines will not fit with increment2 (or if you have not 
supplied increment2), SOS chooses a smaller increment. 


If SOS cannot choose a small enough increment, it inserts another page 
mark, moves the lines with numbers intact, and inserts a final page 
mark. 


If the source range contains page marks, SOS tells you the increment 
it uses for the lines copied after the final page mark. The message 
is INC2=n if SOS does not have to insert a final page mark, and 
INC2=ORDER n AND P/M INSERTED if it does insert one. 


If the specification of the source range contains the shorthand symbol 
*, meaning the first line on a page, SOS duplicates the page mark that 
precedes the first line before it begins to move the text. If the 
range specification contains *, meaning the last line, SOS duplicates 
the following page mark as well. 


Note that SOS duplicates the page mark(s) whether you specify the 
symbols “~ and/or *, or whether SOS supplies them as defaults. Thus, 
SOS duplicates the preceding page mark if you type the range 


SBEGOSA 


This is because the initial line number for page 3 defaults to “. SOS 
copies the succeeding page mark if you type the range 


20/3374 
This is because the final line number for page 4 defaults to *. Tf 
you type only a single page number for the range, SOS copies both the 
preceding and the succeeding page marks for that page. For example: 
raw) 


This is because SOS expands /5 to */5:*/5. 
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WwW 
Save World 


5.17 SAVE WORLD (W) 
Formats: 


W[:file-spec] 
WB[:file-spec] 


Arguments: 


file-spec 
If given, specifies the output file. If you omit file-spec, SOS 
uses the current output file specification. 


WB 
Tells SOS not to increment the version number of the output file. 
The previous version of the output file (or the input file, if 
you have not used W before) is overwritten. 


Current line: 
The Save World command does not affect the current line. 


The Save World command directs SOS to write the current version of a 
file being edited to disk. SOS tells you the name of the file it has 
written, After the command, you remain in Edit mode, 


Use the Save World command frequently as a precaution against system 
malfunction or against your own errors. If a catastrophe happens, you 
only lose the work done since the last time you saved "everything in 
the world." Section 4.3 gives an overview of "defensive editing." 


Each time you use the W command, the current contents of the file are 
overwritten on the output file. Thus, if you repeatedly use the W 
command without giving a different file specification, you are 
repeatedly updating a single back-up file. To obtain a chronological 
string of back-up files, use W with a different file specification 
each time. 


WB tells SOS not to increment the version number before writing the 
output file. This option of the Save World command is effective only 
if it is the first W command given. That is, once a W command has 
been issued, the version number of the output file has been 
incremented. All subsequent W or WB commands use that same version 
number. Only if WB is the first Save World command will it overwrite 
the original input file; otherwise WB is equivalent to WwW. sos 
overwrites the input file with the current contents of the file you 
are editing, and returns you to Edit mode. 
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Extend 
5.18 EXTEND (X) 
Format: 
X[range] [,N] 
Argument: 
range 
Specifies the range of lines to be extended one at a time. If 


you omit range, the current line is extended. 
Option: 


N 

’ 
Tells SOS to print only the line number of each line in the 
range. 


Current line: 


After SOS completes an eXtend command, it sets the current line to the 
last line in the range that was extended, 


The eXtend command adds text to the end of lines. It does this by 
acting as if you had typed A (to enter Alter mode), <TAB> (to reach 
the end of the line), and I (to begin inserting text). Alter mode is 
described in detail with the Alter command in Section 5.1. 


SOS enters Alter/insert mode for each line in the range that you 
specify. It prints the line and waits in Alter/insert mode. If you 
specify ,N, SOS prints only the line number. At any time you can type 
<ESC> to end insertion and then give any Alter-mode command. For 
example, typing L moves the intraline pointer to the beginning of the 
line, so you can make changes before the text you have just inserted. 


If you type <DEL> while inserting text, the previous character is 
deleted. <DEL> echoes as a pair of backslashes followed by the 


deleted character. Successive <DEL>s delete and echo previous 
characters in turn. The next non<DEL> character that you type is 
echoed as a second pair of backslashes followed by the character. Tf 


you type more <DEL>s than the number of characters you have inserted 
after the eXtend command, SOS deletes characters in your original 
line. 


If you insert so much text that the overall length of the line exceeds 
500 characters, SOS prints the message LINE IS TOO LONG and returns 
you to Edit mode. Any changes that you may have made to the line up 
to that point are discarded. 


If you type <LF> after the eXtend command (that is, while in 
Alter/insert mode), SOS creates a new line to receive the rest of the 
inserted text. The number of this new line is determined as follows: 


1. The current line-number increment is added to the current 
line number. 


2. If an existing line intervenes between the current line 
number and this new number, the new line is numbered halfway 
in between. 
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3. If the next existing line is numbered higher by 1 than the 
current line, a bell sounds and no new line is created. 


If no errors occur and the new line is created, the intraline pointer 
is positioned at the beginning of the new line; SOS is still in 
Alter/insert mode. 


After an eXtend command, while in Alter/insert mode, any character you 
type (with seven exceptions) is inserted into the text line. Many 
control characters do not have their usual effect when entered in 
Alter/insert mode. For example, <CTRL/S> and <CTRL/O> have no effect 
on terminal output. They are simply inserted into the text line 
without interpretation. 


The following seven characters are not treated as text in Alter/insert 
mode: 


ends insertion. 

ends the eXtend command for this line. 
deletes the previous character. 
creates a new text line. 

returns SOS to edit mode. 

retypes the line 

gets the attention of DCL. 


Tm) 

AIGA Ae 

EI 328A 
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. (period) 
Move Position 


5.19 MOVE POSITION (.) 
Format: 

-position 
Argument: 


position 
Specifies the new current position (line/page). 


Current line: 


After SOS completes a Move Position command, it sets the current line 
to the line specified by the position argument. 


This command resets the current line. If you specify a nonexistent 
line or page number, SOS prints NO SUCH LINE EXISTS, and does not 
change the current line. Otherwise, the only response is’ the 
Edit-mode prompt *. 


Examples: 


*,220/2 


Set the new current position to line 220, page 2. 
x, aml 


Set the new current position to the fifth line before the present 
position. Note that, if at present the current line is less than 
five lines from the beginning of a page, then *“/. is the current 
position after the command. 


He /et2 
Set the new current position to the line that has the same number 


as the current line, on the page that is two pages beyond the 
current page. 
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= (equal) 
Give Parameter 


5.20 GIVE PARAMETER (=) 
Format: 

=parameter 
Argument: 


parameter 
Specifies any legal SOS parameter or switch. Parameters and 
Switches are listed in Tables 6~1 and 6-2 (see Chapter 6). 


Current line: 
The Give Parameter command does not affect the current line. 


This command returns the value of SOS parameters and switches. sos 
parameters can have values of integers, strings, characters, or 
positions (line/page). A switch is an SOS internal variable that can 
have one of two values: on or off. 


The following examples show some useful parameters and switches. . 


Examples: 


x=bis 
4 
x 


Print the page number of the largest page in the file. 


x=NAME 


DBR2$ CMANNIPAYROLL .MST#3 
x 


Print the current specification of the output file. This is’ the 
file-spec used by the Save World and End commands, 


x=STRING 
FIND— 

isomer 

SURSTITUTE- 

stochastic 
FOR- 

random 

x 


Print the values of the current Find and Substitute strings. 
These are handy to know when using these commands repeatedly 
through a_ file. The string identified as SUBSTITUTE- is 
newstring, and FOR- is oldstring (see the description of the 
Substitute command in Section 5.15). 
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/ (slash) 
Set Parameter 


5.21 SET PARAMETER (/) 
Format: 
/parameter [:value] 
Arguments: 
parameter 
Specifies any SOS switch or parameter that can be set (see Tables 


6-1 and 6-2 in Chapter 6). 


value 
Specifies a legal value for that parameter. See the descriptions 
of the individual parameters in Section 6.1. 


Current line: 

The Set Parameter command does not affect the current line. 

This command sets the value of SOS parameters and switches. You are 
allowed to set any of the switches, but you can set only nine of the 


16 parameters. Table 6-2 shows which parameters you can set. 


After setting the requested parameter or switch, SOS prints’ the 
Edit-mode prompt *, 


The examples below demonstrate setting some of the more frequently 
used SOS parameters and switches. All are described in Chapter 6. 


Examples: 


X/isaveilo 


Perform an automatic Save World command after every 10 lines 
added in Input mode. 


X/exrert 


The user claims to be an expert at using the editor: issue 
shorter error messages; do not request confirmation before 
deleting text; and do not display deleted text in Alter mode. 


K/PLINES 3 23 


Print 23 lines of text, starting at the current line, when SOS 
receives P followed by <RET>. This is a useful value of PLINES 
for users with video display terminals that show 24 lines of text 
on the screen (especially if the terminal's speed has been set to 
a high baud rate, for instance 1200 baud or above). 
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@ (at) 


Execute Command File 


5.22 EXECUTE COMMAND FILE (@) 
Format: 

@file-spec 
Argument: 


file-spec 
Specifies a file containing SOS commands, 


Current line: 


After SOS completes a Command File command, it sets the current line 
to the last line modified by a command in the file. 


Command File lets you place a repetitive or frequently used series of 
commands in ae file. SOS executes the commands from the file as if 
they came from the keyboard. 


Once SOS begins executing a Command File command, it performs all the 
commands in the file, returning control to the keyboard only when it 
reaches the end. However, SOS prints the following items on _ the 
terminal: 


e Error messages 

e Printouts from the Print command 

e Lines found by the Find command 

e Changes made by the Substitute command 
e Lines altered by the Alter command 


SOS also requests input from the terminal if the command file contains 
a Substitute command that places the editor in Decide mode. 


If the file type field of the command-file specification is CMD, you 
can omit the file type when giving the file specification. 


Command files can be nested to a depth of three levels. That is, a 
command file can contain a Command File command; that file can 
contain another Command File command. If you attempt to nest command 
files to a depth of four or more, SOS prints MAXIMUM COMMAND FILE 
DEPTH EXCEEDED and issues the Edit-mode prompt *. 


You can use command files to shorten the typing of common’ commands. 
For example, you might create two files named L.CMD and W.CMD as 
shorthand for commonly used Print commands: 


Lo CMDS 
PR-G/KISG 


W.CMI3 
Pen S16 


If these two files are in your directory, you can type @L<RET> to see 
the last six lines in a file, and type @W<RET> to see a “window" of 
six lines surrounding the current line. 


5-56 
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Another use for Command File is in repetitive editing. Consider’ the 
task of deleting the final three characters on each of 400 lines ona 
page. This task would be tedious to perform by hand, and prone to 
error as well. The example below shows how to build and use a command 
file to do the required deletion. 


Example: 


In this example, the user (whose name is Lyles) generates a command 
file named DEL.CMD. The first line contains an X (eXtend) command 
with a range of 100 lines. (Lyles gives four Command File commands to 
delete the 400 lines.) The remaining 100 lines in DEL.CMD contain 
identical Alter-mode command sequences that perform the deletion on 
each line in turn. 


Lyles uses the eXtend command, instead of the Alter command, to 
suppress typeout of the lines being altered. The ,N option of eXtend 
allows this. Since eXtend leaves SOS in Alter/insert mode, the first 
Alter-mode command is <ESC>, which returns SOS to Alter-mode command 
level. The subsequent command deletes the previous three characters 
(the last three characters in the line). 


To get an escape character into the file, Lyles uses the Set Parameter 
command /ESCAPE to set the logical escape character to the plus sign 
(+). Thus, when Lyles inserts line 200 and types +, SOS inserts an 
escape character into the file. (For details, see Section 6.1.) 


After entering the line of Alter-mode commands, Lyles uses the Copy 
command to replicate the line the required 100 times. Note that, 
after seven copy commands, there are 128 replicated lines; Lyles 
deletes the excess. 


$ EDIT DEL.CMD 
INPUT OBASICLYLESINEL. CMI 1 


00100 X.!1009N 
*X/ESCAPE $+ 
KIX 

00200 +~30 
00300 ESC 
#OXK¥ 200 
INC1=100 
XOK»2002K 
INC1=100 
XOX» 2002X 
INC1=100 
*OX*2003% 
INC1#100 
¥OXx2003% 
INC1=100 

xP xX 

03300 ~30 
#O% 2 2003 % 
INC1=100 
¥OK22003% 
INC1=100 

xP Xx 

12900 ~30 
x11 02002% 

28 LINECS) DELETED (10200/1212900). 
¥*E 


COBAZICLYLESIDEL .CMNF 1] 
$ 
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Now Lyles edits the file in which the deletions are needed. The 400 
lines are on page 3, numbered 10 to 4010. Because the eXtend command 
in DEL.CMD uses the current line (.), Lyles sets the current line to 
the next unedited line before typing @DEL. Immediately after giving 
each Command File command, Lyles types <CTRL/O> to suppress all 
printout. SOS completes the command and issues the Edit-mode prompt. 


$ EDIT DIREC.COR 


EQITSDBASSCILYLESIDIREC.COR#12 


K./3 
X@0EL 


01010 Gunthers Jaw sereseoee 
01020 Gurskasy Andrew seseree 2 
X@DEL 

CTRL) 

KF ALR 

92020 Mosherd:s Tom seseeveee 
02030 Modeems ALICS seeveser 41 
Xx@DEL 

CIRO) 

Ke atl 

CNEL 


ho 


04000 ZOS@ly MAri@® corserees 
04010 Zusks Raymond seeceees 


CHAPTER 6 


SOS PARAMETERS AND SWITCHES 


SOS maintains a number of internal parameters and switches that 
control different aspects of its operation. You can set and reset 
some of the parameters and switches from the terminal. Tables 6-1 and 
6-2 list the parameters and switches, their initial values, and their 
minimum abbreviations in upper case characters. 


A switch in SOS is an internal variable that can have one of two 
values: on or off. Switches are set with the Set Parameter command 
(/) and interrogated with the Give Parameter command (=). All 
switches can be turned off by prefixing NO to their names in a Set 
Parameter command. 


A parameter can have a range of values. Most parameters have integer 
values: 


BIG INCREMENT ISAVE 
LENGTH PLINES SAVE 
START STEP SUBSTITUTE 


Four parameters have values that are text strings: 


ERROR 
ID 
NAME 
STRING 


Two parameters have values that are positions (line/page pairs): 


LOCATION 
Two parameters have values that are single characters: 


ESCAPE 
MATCH 


Some of the parameters and switches can be specified as qualifiers in 
the initial DCL EDIT command. They can also be specified by using the 
symbol-assignment mechanism (see Section 6.3). The parameters’ and 
switches that you can preset in the EDIT command are: 


INCREMENT BAK 
ISAVE DECIDE 
PLINES EXPERT 
SAVE LINE 
START LOWER 
STEP NUMBERS 
READONLY 
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TABLE 6-1 
SOS PARAMETERS 
Name! Set from _Preset F Meaning 
Edit Mode? via DCL? Value 
BIG n ~ Displays highest page number 
ERRO;r n (null) Displays last error message 
ESCApe y (null) Sets character for input/output of escapes 
ID n - Displays current SOS version number 
INCRement y y 100 Sets increment for numbering inserted lines 
ISAVe y y 0 Controls auto-W on inserts 
LENGth y 55 Sets page size for List command 
LOCAtion n “71 Displays first line in edit buffer 
MATCh y (null) Sets special pattern-matching flag character 
NAME n ~ Displays output file specification 
PLINes y y 16 Sets number of lines printed by Peet) 
SAVE y y 0 Controls auto-W on commands 
STARt y y 100 Sets starting line number 
STEP y y 100 Sets increment for initial line numbering 
STRIng n (null) Displays current Find and Substitute strings 
SUBStitute n 0 Displays number of matches in last Substitute 
n 00000/1 Displays current position 





1 Minimum abbreviation is given in uppercase letters. 
? You can specify these parameters as qualifiers in the initial DCL EDIT command, or by using the symbol- 


assignment mechanism (see Section 6.3), 


TABLE 6-2 
SOS SWITCHES 





BAK 
DECIde 
EXACt 


on 
























EXPErt 
LINE 
LOWEr 
NUMbers 

READonly 
SEPArator 
SEQUence 

























Initial Preset i 
Value via DCL?? 











Tells SOS to create back-up file 


Sets auto Decide mode on Substitute 
Requires exact case match for Find, Substitute, content- 


specification 


Declares experienced SOS user 


Tells SOS to use existing line numbers 


Tells SOS to accept uppercase, lowercase as is 
Tells SOS to display line numbers 

Starts SOS in Read-only mode 

Tells SOS to treat _$ . as alphanumeric 





Leaves output-file line numbers 








1 Minimum abbreviation is given in uppercase lett 
? You can specify these switches as qualifiers in the initial DCL EDIT command, or by using the symbol- 
assignment mechanism (see Section 6.3). Turn off any switch by using the letters NO before its name; 

thus, NOLINE turns off the LINE switch. 


ers. 
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6.1 PARAMETERS 
BIG 


Value: 
Integer: the largest page number now in the file. 


Default: 
Null. 


Sets 
Cannot be set by uSer. SOS resets BIG when you add or delete 
pages, and (if necessary) when you interrogate it with =BIG 


Interrogate: 
Use =BIG 


When you give the command =BIG for the first time, SOS searches 
through the entire file, inserting page marks if it finds lines out of 
order, until it reaches the end of the file. The following output is 
typical. 


*XEBIG 


LINES OUT OF ORDER 
F/M INSERTED FOR FAGE 2 


LINES OUT OF ORDER 
F/M INSERTED FOR FAGE S 
7 


x 


In this example, SOS returns the value 7 as the highest numbered page 
in the file. The message LINES OUT OF ORDER might result from 
concatenating line-numbered files, for example with the DCL command 
COPY. ‘ 


ERROR 


Value: 
String: the last error message SOS printed. 


Default: 
Null. 


Set: 


Cannot be set by user. SOS resets ERROR each time it prints an 
error message. 


Interrogate: 
Use =ERROR 


SOS always prints the long form (that is, the NOEXPERT form) of the 
last error message. It does this even if the EXPERT switch is on. 
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ESCAPE 


Value: 
Character: when input, causes SOS to insert an escape character 
into the file; also, the character that SOS prints when it 
encounters an escape character in text. 


Default: 


Initially null. When you do not specify a character (/ESCAPE), 
the default is dollar sign (S$). 


Set: 
Use /ESCAPE:x 


Interrogate: 
Use =ESCAPE 


This parameter defines a "logical escape" character that lets you 
insert an escape character into a text file, and lets SOS display 
escape characters in text that it types out. One reason for inserting 


escape characters into text files is to use the Find and Substitute 
commands in command files (see Section 5.22). 


This parameter is initially null, so you cannot insert escape 
characters into the text. When you issue the following Set Parameter 
command, SOS uses the default value of $ as the logical escape 
character. 
x/ESCAPE 
The logical escape is used in three ways: 
e SOS inserts an escape character into the text whenever you 
type $ in Input mode, in Alter/insert mode, or in the 
newstring of a Substitute command. 


e SOS prints $ whenever it encounters an escape character in 
text to be typed out. 


® SOS searches for an escape character when you type $ in a Find 
command or in the oldstring of a Substitute command. 


You can select another character to act as the logical escape 
character by typing: 


*/ESCAPE 3 x 
where x represents the new logical escape character. 
NOTE 


You cannot use any of the _ following 
characters as a logical escape: 


roe fb]. = 


These characters are meaningful in file 
specifications. 


To disable the logical escape feature, type: 
x/ESCAPE? 


Note that the colon must be typed. 
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ID 
Value: 
String: the current version number of SOS. 
Default: 
The current version. 
Set: 
Cannot be set by user. 
Interrogate: 


Use =ID 


SOS responds to the command =ID with its current version number. If 
you experience problems with the text editor software, ascertain the 
version number of SOS So you can report it to DIGITAL service 
personnel. For example: 


x=Th 
$08 V02.04A 
x 


INCREMENT 


Value: 
Integer: the line-number increment SOS uses to assign the next 
line number for input text. 


Default: 
100 


Set: 
Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /INCREMENT:n. SOS changes 
INCREMENT when you give an Input or Replace command with a second 
argument (comma-delimited) to update the line-number increment, 


Interrogate: 
Use =INCREMENT 


INCREMENT is the line-number increment SOS useS to calculate line 
numbers for new lines created in Input or Alter/insert mode, You can 
set this parameter directly by using the Set Parameter command. 
However, the more common way to change its value is by supplying an 
increment argument to the Input or Replace commands. 


ISAVE 
Value: 
Integer: number of lines of input text between automatic file 


saves. 


Default: 
0 (auto-save turned off). 


Set: 
Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /ISAVE:n. 

Interrogate: 


Use =ISAVE 
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This parameter controls one of SOS's automatic file-saving options 
(the other is controlled by SAVE). When you set ISAVE -- for example, 
/ISAVE:10 -- SOS automatically performs a W command each time you 
insert ten more lines into the file using the Insert or Replace 
commands. 


ISAVE initially has the value zero, so auto-saving is disabled on 
inserts. To disable ISAVE once you have set it, reset it to zero. 


LENGTH 


Value: 
Integer: page length for the List command. 


Default: 
55 


Sets 
Use /LENGTH:n 


Interrogate: 
Use =LENGTH 


LENGTH represents the page length for printer listings generated by 
the List command. Its initial value is 55 lines. Thus, SOS starts a 
new page in the printer listing whenever it encounters a page mark, 
and also whenever it has printed 53 lines without encountering a page 
mark (the listing heading requires two lines). 


LOCATION 


Value: 
Line/page: the position of the beginning of SOS's edit buffer. 


Default: 
“71 


sets 
Cannot be set by user. SOS keeps track of LOCATION as it reads 
from the input file and writes to its temporary files. 


Interrogate: 
Use =LOCATION 


The edit buffer contains all the text that is immediately accessible 


to SOs. If you issue a command that affects lines outside this 
buffer, SOS must read text from the input file before performing the 
command. (See Chapter 8, "SOS Internals.") For example, if you 


request the printout of a line earlier in the file than the position 
LOCATION, SOS must write the remainder of the file (after the current 
position) to its temporary file, and then read from the input file up 
to the line you requested. 


SOS PARAMETERS AND SWITCHES 


MATCH 


Value: 


Character: the flag character for special pattern-matching in 
Find and Substitute commands. 


Default: 


Initially null. When you do not specify a character (/MATCH), 
the default is ? (question mark). 


Set: 
Use /MATCH[:x] 


Interrogate: 
Use =MATCH 


This parameter defines a flag character for SOSs's special 
pattern-matching feature (see Section 7.1). MATCH is initially null, 
So special pattern-matching is disabled. 


When you issue the following Set Parameter command, SOS uses’ the 
default value of ? as the flag character. 


x/MATCH 


In Find and Substitute strings, certain groups of characters beginning 
with ? are interpreted in a special way (see Section 7.1). 


You can select another character to act as the special 
pattern-matching flag character by typing: 


x/MATCH ES x 
where x represents the new flag character. 


To disable special pattern-matching, type: 


x7MATCHS 


Note that the colon must be typed. 


NAME 
Value: 
String: the specification of the output file. 
Default: 
The specification of the input file. 
Set: 


Cannot be set by user. SOS changes NAME when you issue a Save 
World command, giving a new file specification. 


Interrogate: 
Use =NAME 


After you issue a Save World command, the parameter NAME contains’ the 
file specification that SOS would use for the output file if you gave 
an End command (without naming a new file). Before you have issued a 
Save World command, NAME contains the input file specification. 
However, if you explicitly gave an output file specification when you 
initiated SOS (/OUTPUT=file-spec), NAME initially contains this 
specification. 
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PLINES 


Value: 
Integer: the number of lines SOS prints upon receiving a Print 
command without arguments. 


Default: 
16 


Set: 
Append as a qualifier to the EDIT command; or set by the symbol 
assignment mechanism; or use /PLINES:n,. 


Interrogate;: 
Use =PLINES 


SAVE 

Value: 
Integer: number of text-changing commands between automatic file 
saves. 

Default: 
0 (auto-save turned off). 

Set: 


Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /SAVE:n,. 


Interrogate: 
Use =SAVE 


This parameter controls one of SOS's two automatic file saving options 
(the other is controlled by ISAVE). When you issue the command 
/SAVE:20, for example, SOS automatically performs a Save World command 
each time you issue the 20th text-changing command (listed below). 


Commands that do not change the file are not included in this count. 
Text-changing commands are defined as the commands that are illegal in 
Read-only mode: 


Alter Copy Delete 
Insert Join Kill Page Mark 
Mark reNumber Replace 
Substitute Transfer eXtend 

START 

Value: 


Integer: the line number SOS gives to the first line in a file, 
and/or to the first line on a page, in an unnumbered file. 


Default: 
100 


Set: 
To override SOS's initial default value, append as a qualifier to 
the EDIT command, or set by the symbol-assignment mechanism; or 
use /START:n. 
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Interrogate: 
Use =START 


If you reset START midway through editing a file that was initially 
unnumbered but that contained page marks, SOS numbers subsequent pages 
(that it has not yet encountered) using the new starting line number. 


STEP 

Value: 
Integer: the line-number increment SOS uses to assign line 
numbers to an unnumbered file. 

Default: 
100 

Set: 


To override SOS's initial default value, append as a qualifier to 
the EDIT command, or set by the symbol-assignment mechanism; or 
use /STEP:n. Use it as a qualifier to the initial DCL EDIT 
command or use the symbol-assignment mechanism (see Section 6.3). 


Interrogate: 
Use =STEP 


STEP is the default line-number increment SOS uses to number the lines 
of an unnumbered input file. SOS assigns line numbers as it reads in 
the lines. Therefore, you can change STEP at any time to affect the 
line-number increment for the lines that SOS has not yet accessed in 
an unnumbered file. 


STRING 


Value: 
String: the current Find and Substitute strings. 


Default: 
Null. 


Set: 
Cannot be set by user. SOS updates STRING whenever you issue a 
new Find or Substitute command. 


Interrogates: 
Use =STRING 


The parameter STRING contains the values of three search strings: one 
for the Find command and two for the Substitute command. Any of these 
search strings can contain multiple strings, if such strings were 
specified in the last Find or Substitute. For example: 


x= STRING 

FING 
Alter mode Find command strings 
Alter-mode 

SUBSTITUTE 
Lecicde mode Gubstitute conmand newstrings 
fecide-mode 

FOR 
decide mode Substitute command oldstrings 
decide-node 
* 
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It is sometimes useful to issue =STRING when you are using the Find 
and/or Substitute commands without arguments; that is, when you are 
searching for strings specified in a previous complete command. 


SUBSTITUTE 


Value: 
Integer: the number of substitutions performed by the last 
Substitute command. 


Default: 
0 


Set: 


Cannot be set by user. SOS updates SUBSTITUTE after every 
Substitute command, whether successful or not. 


Interrogate: 
Use =SUBSTITUTE 


This parameter is useful because it tells you how many substitutions 
SOS performed in a Substitute command with the ,N option (in which the 
lines changed are not printed out). 


If you entered Decide mode with the last substitute command, and if 
you entered Decide Alter mode for any line, the SUBSTITUTE parameter 
reflects the total number of possible substitutions for that line. 
This is true even if, in Decide Alter mode, you undo one or more of 
the substitutions. 


- (Period) 


Value: 
Line/page: SOS's current position. 


Default: 
00000/1 


Set: 
Use .position. SOS updates this parameter after every command 
that affects a line. 


Interrogate: 
Use =. 


6.2 SWITCHES 


SOS switches are summarized in Table 6-2. All switches can be’ turned 
on with the Set Parameter command; for example: 


*/ BAK 
Several of the switches can be specified as qualifiers to the initial 
EDIT command, or by using the symbol-assignment mechanism (see Section 
6.3). All switches can be interrogated with the Give Parameter 
command: 


X= RAK 
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You can abbreviate switch names to four characters. In all the 
examples below, the full switch names are used. 


Any switch can be turned off by prefixing NO to its name in the Set 
Parameter command. For example, to turn off the Decide-mode switch, 
type: 


x/NOTEC IDE 


For compatibility with other implementations of SOS, you can use the 
minus sign (-) interchangeably with NO to turn off a switch. However, 
you cannot use the minus sign on the initial DCL EDIT command line. 
It is best to use NO in all cases. 


BAK 


Meaning: 
Determines whether SOS increments the version number of the 
output file. 


Default: 
BAK is on. 


Set: 
Append as qualifier to the EDIT command; or use /BAK or /NOBAK 
(after initialization, SOS does not set this switch). 


This switch determines whether SOS increments the version number of 
the output file when you issue the first Save World command in an 
editing session, or when you issue End without a previous Save World. 
If BAK is on, SOS increments the version number. If BAK is off, SOS 
does not increment the version number, but instead overwrites’ the 
input file. 


The setting of the switch is not meaningful if you give a new file 
specification with the Save World or End command. This is because the 
new file specification obviates the question of whether or not you 
want a back-up file. The setting is also not meaningful after you 
issue the first Save World command. 


DECIDE 


Meaning: 
Determines whether SOS automatically enters Decide mode for each 
Substitute command. 


Default: 
DECIDE is off. 


Set: 
Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /DECIDE or /NODECIDE (after 
initialization, SOS does not set this switch). 


If DECIDE is on, SOS enters Decide mode each time you issue a 
Substitute command. The effect is as if you issued each Substitute 
command with the ,D option. 


The DECIDE switch provides an automatic way of protecting against 
operator errors. Therefore, a user who is just beginning to learn SOS 
May want to set this switch. 
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EXACT 


Meaning: 
Determines whether SOS requires an exact match (uppercase and 
lowercase letters) in pattern searches. 


Default: 
EXACT is off. 


Set: 
Use /EXACT or /NOEXACT (after initialization, SOS does not set 
this switch). 

If EXACT is on, SOS requires an exact pattern match for: 
e All Edit-mode Find and Substitute command searches 


e All Alter-mode S and K command searches 


e All content-specified searches (see Section 7.2) 


EXPERT 


Meaning: 
If EXPERT is on, SOS assumes you are an experienced SOS user. 


Default: 
EXPERT is off. 


Set: 
Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /EXPERT or /NOEXPERT (after 
initialization, SOS does not set this switch). 


Declaring yourself an expert SOS user (/EXPERT) has four consequences: 


e The error and informational messages SOS types are more brief 
than those for nonexperts. 


e SOS does not request confirmation before deleting text across 
page boundaries, or before deleting all text on a page. 


e SOS does not report how many lines it deletes when you issue a 
Delete or Replace command. 


e In Alter mode, SOS does not display deleted characters between 
pairs of backslashes (\\...\\). Thus, the appearance of lines 
as you edit them in Alter mode corresponds more closely to the 
actual contents of the lines. 
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LINE 

Meaning: 
Determines whether or not SOS uses line numbers that may _ be 
present in an input file. 

Default: 
LINE is on (that is, SOS uses existing line numbers). 

Set: 


Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /LINE or /NOLINE (after 
initialization, SOS does not set this switch). 


If you turn off the LINE switch by the logical name mechanism, or if 
you initiate SOS with the qualifier /NOLINE, SOS ignores line numbers 
that may be present in the file it reads. The file is renumbered. 
SOS does not print the usual message indicating the absence of line 
numbers (INPUT ASSUMED UNSEQUENCED). 


LOWER 


Meaning: 
Determines whether or not SOS translates lowercase characters 
from the terminal to uppercase. 


Default: 
LOWER is on (that is, lowercase letters are not translated to 
uppercase). 


Set: 
Append as a qualifier to the EDIT command; or set by the 
symbol-assignment mechanism; or use /LOWER or /NOLOWER (after 
initialization, SOS does not set this switch). 


A side effect of turning off LOWER is that if the exact character 
match options (,E) of the Find and Substitute commands are used, it is 
impossible to match any lowercase character that is already in the 
file. The EXACT switch, if turned on, has the same side effect. 


NUMBERS 


Meaning: 
Determines whether SOS prints out line numbers that may be 
present in an input file, and whether it prompts with line 
numbers in Input mode. 


Default: 
NUMBERS is on (that is, SOS lists line numbers when it displays 
lines in your file). 


Set: 
Append as a qualifier to the EDIT command, or set by the 
symbol-assignment mechanism; or use /NUMBERS or /NONUMBERS. 


If you turn off the NUMBERS switch by the logical name mechanism, if 
you initiate SOS with the qualifier /NONUMBERS, or if you type 
/NONUMBERS at the Edit mode prompt, SOS does not print line numbers 
when it displays lines of text and does not prompt with line numbers 
in Input mode. 
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SEPARATOR 


Meaning: 
Determines whether SOS treats the three characters ., $, — as 
word delimiters if special pattern-matching is enabled for the 
Find and Substitute commands. 


Default: 
SEPARATOR is off. 


Set: 
Use /SEPARATOR or /NOSEPARATOR (after initialization, SOS does 
not set this switch). 


By setting the switch SEPARATOR, you can make SOS treat the characters 
Par $, and as word-delimiters for purposes of special 
pattern-matching (see Section 7.1). This feature could be useful in 
editing a MACRO program, for instance, in which decimal points, dollar 
signs, and underscore characters appear frequently as parts of 
symbols. 


SEQUENCE 


Meaning: 
Determines whether SOS leaves line numbers in the output file. 


Defaults: 
SEQUENCE is on. 


Set: 
Use /SEQUENCE or /NOSEQUENCE (after initialization, SOS does not 
set this switch). 


If you turn off the SEQUENCE switch and exit with the E command, the 
effect is as if you exited with ES. 


6.3 SETTING DEFAULT CONDITIONS USING SYMBOL ASSIGNMENT 


You can change the parameter and switch values that apply when Sos is 
initiated by using the DCL symbol-assignment mechanism. You can issue 
a symbol-assignment command from the terminal to override the initial 
defaults temporarily; or you can include the command in your LOGIN.COM 
file to override the defaults permanently. 


Ssos's initial default values for parameters and switches are listed in 
Tables 6-1 and 6-2, and discussed briefly in Section 4.1. You can 
override these defaults in three ways upon starting the editor. 


1. To override the defaults for the current editing session 
only, use qualifiers to the EDIT command line. For example: 


$ EDIT/INCREMENT?2 file-srec 


2. To override the defaults for all editing sessions within the 
current job (that is, until you log off the system), issue a 
symbol-assignment command from the terminal: 


$ SOS3="EDIT/SOS/ INCREMENT #2" 


3. To override the defaults for all future editing sessions, 
place a symbol-assignment command (similar to item 2 above) 
in your LOGIN.COM file, 
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The symbol-assignment command associates a character string with a 
symbol. In item 2 above, the character string EDIT/SOS/INCREMENT:2 is 
associated with the symbol SOS. Typing SOS or SOS file-spec then 
becomes your own private way of initiating the editor with the 
qualifier /INCREMENT:2. Such a symbol assignment lasts until you log 
off the system. 


To define a symbol that lasts from one job to the next, perform the 
symbol assignment in the file LOGIN.COM. This command procedure file 
contains commands that are automatically executed each time you log in 
(see the VAX/VMS Command Language User's Guide). 


You can include more than one SOS parameter or switch in a_ symbol 
assignment. Use a minus sign (-) in the last character position to 
continue a long line. 


As an example, suppose you have the following line in your LOGIN.COM 
file: 


SOS3="EDIT/SOS/LOWER/STEF 2 10/START? LO/ INCREMENT 2 2/FPLINES310" 
When you type SOS or SOS file~spec to initiate the editor, the 
parameters and switches specified in the symbol assignment are applied 
as qualifiers. Therefore, the following conditions hold: 


e Lowercase input is accepted as is, and is not converted to 
uppercase, 


e If SOS reads an unnumbered file, it numbers the lines by 10s, 
starting at 10. 


e SOS uses a line-number increment of 2 for inserted lines. 


e SOS prints 10 lines, starting at the current line, upon 
receiving P. 


CHAPTER 7 


SPECIAL CONSTRUCTS AND CHARACTERS 


The sections within this chapter discuss the pattern-matching 
constructs used to search for strings, specifying ranges by content 
rather than line number, and the special characters recognized by SOS. 


7.1 SPECIAL PATTERN-MATCHING CONSTRUCTS 


One SOS feature that allows great flexibility in searching for strings 
using the Find and Substitute commands is special pattern-matching. 
This feature is initially disabled. You control it by means of the 
MATCH parameter (see Section 6.1). 


The Set Parameter command /MATCH:x enables special pattern-matching. 
The character x acts as a flag to mark the special pattern-matching 
constructs. A construct is a group of two or more characters 
beginning with the flag character. When SOS encounters such a 
construct in a Find or Substitute command, it treats it as a single 
character with a particular meaning for its pattern search, as 
detailed below. 


If you issue the command /MATCH without specifying a flag character, 
SOS uses the question mark (?) by default as the special-constructs 
flag. The examples given later in this section use ? as the flag. 


To disable special pattern-matching, and to divest the flag character 
of any special meaning, type /MATCH:. Note that you must type the 
colon. 


Table 7-1 lists the special constructs, Some of the constructs are 
used in find strings (the string argument of Find and the oldstring 
argument of Substitute), while others are used in substitute strings 
(the newstring argument of Substitute). Sections 7.1.1 and 7.1.2 
describe these two classes of special pattern-matching constructs. 
Section 7.1.3 describes combining find-string constructs, and the 
internal representations of constructs are discussed in Section 7.1.3. 
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Table 7-1 
Special Pattern-Matching Constructs 





roc msn imam neti nina eT pth entntenttntimnnstenns PN 


Con- Internal Meaning 
struct represen- 
tation 


Find-string constructs: 


?/ Match any character 

23 | Match any separator 

P< Match a space or tab 

2x Match any character except x 

?)x Match 0 or more of the character x 

?P1x @TALN) Match 1 or more of the character x 

79 CTRL) Match any alphanumeric character 

2! Match any letter (A-Z, a-z) 

?& CIAL) Match any uppercase letter (A-Z) 

?2 (HiT8i7) Match any lowercase letter (a-z) 

P+ CIALP) Match any decimal digit (0-9) 

?> CTRL Match beginning or end of line 

?7¢c GIRLS) Match internal representation of c 
Substitute-string constructs: 

an CTRL) Substitute next string matched 

?¥n2* CTRLIO) Substitute nth string matched 














7.1.1 Find-String Constructs 


You can use the constructs given below in the Find command, or in the 
oldstring of the Substitute command. 


?/ Match Any Character 


This construct matches any character. As an example of its use, 
suppose you want to locate variables that start with B in a MACRO 
program, but you do not want to see lines with labels that start with 
B. Since labels start in column 1, they are never preceded by any 
other character. Thus, the following Find command locates the desired 
variables: 


*x/MATCH 
xF 7 /B vAV999 
00250 Lit MOV 


The ,A in the Find command tells SOS to enter Alter mode when a match 
is found, In Alter mode, the intraline pointer points before the 
first character of the pattern matched. 


?: Match Any Separator 


This construct matches any separator, that is, any character except a 
letter, a number, or the characters ., $, and . (If the switch 
SEPARATOR is turned on, these three characters also are considered 
separators. See Section 6.2.) The ?: construct is useful in 
searching for words that, besides appearing in isolation, may be 
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imbedded in other words as well. For example, suppose you want to 
find all occurrences of the word "can"; however, you are not 
interested in words like incandescent, canonical, and so forth. You 
can issue the following Find command: 


KP? itcan?t GO /137%1999 


The ?: constructs before and after the word are matched by a tab or a 
space. Note that, unless the command /SEPARATOR was given, this Find 
command does not match the word "can" if it ends a sentence. SOS does 
not treat the final period as a separator. The Find command does work 
if the word "can" begins or ends a line, however, because SOS 
considers the beginning and end of a line to be separators. 


?< Match a Space or Tab 


This construct matches a space or a tab character. Thus, it 
represents a subset of the ?: (match any separator) construct 
described above. The following command has the same effect as_ the 
example command in the previous section: 


RPP coanPe ES et fk 99 


This Find command does not match the word "can" if it begins or ends a 
line, or if it ends a sentence. A Find command that overcomes these 
limitations is given in Section 7.1.3. 


?%x Match Any Character Except x 


This 3-character construct matches any character except the final 
character of the construct: any character that x would not normally 
match. Thus, a?%bc matches aac, acc, adc, and so forth, but not abc. 


?)x Match O or More of the Character x 


This construct matches the character that follows, any number of times 
that it appears. Thus, a?)bc matches ac, abc, abbc, and so on. SOS 
matches the first such string it encounters. 


This construct cannot be used as the last or only element in a search 
string; ?)x must be bounded on both sides by some character or 
String of characters. Thus, the command F?)x<ESC> is illegal, and 
results in the error message ILLEGAL SEARCH STRING GIVEN. Such a 
construct, if legal, would match every line. 


?lx Match 1 or More of the Character x 

This construct is similar to the one described above, except that it 
matches one or more occurrences of the given character. Thus, a?lbc 
Matches abc, abbc, abbbc, and so on, but not ac. SOS matches’ the 
first such string it encounters. 

?9 Match Any Alphanumeric Character 


This construct matches any character in the ranges A-Z, a-z, and 0-9. 
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?! Match Any Letter (A~Z, a-z) 


This construct matches any uppercase or lowercase letter. You could 
use it, for example, to find all lines in a file that contain the 
strings Mr., MsS., or Dr.: 


X/maten 
xf PIPL, GO S1I/K99 


This Find command prints all lines that contain a space followed by 
two letters (of either case), followed by a period. 


?& Match Any Uppercase Letter (A-Z) 


This construct matches any uppercase letter, For example, 101-?& 
matches 101-A, 101-B, and so on, but not 101-7 or 101-f. 


?2 Match Any Lowercase Letter (a-z) 


This construct matches any letter in the range a-z. For example, (?2) 
matches (i), (j), and so on, but not (A) or (4). 


?+ Match Any Decimal Digit (0-9) 


This construct finds a number. For example, ?+?+?+-A matches 101-A, 
203-A, and so on, but not DEF-A. 


?> Match Beginning or End of Line 


This construct is useful in searching for a string that begins or ends 
a line. For instance, suppose you want to search a MACRO program for 
all labels of the form Ln:. You do not want to see lines in which 
these labels are referred to. Since labels occur at the beginning of 
lines, the following Find command performs the desired search. 


KFPSL?P+? €O /erE 


Here the ?> construct matches the beginning of a line, and the ?+ 
construct matches any digit. 


?7¢ Match Internal Representation of c 


This construct matches the character that S0S uses internally to 
represent the construct c. These internal representations are given 
in Table 7-1. For example, suppose you need to search for the 
character <CTRL/F>. As Table 7-1 shows, SOS uses <CTRL/F> internally 
to represent the construct ?& (match any uppercase letter). Thus, to 
locate <CTRL/F>, use the combined construct ?7?&. 


The use of the ?7 construct should be rare. Normally, in the 
infrequent instance when you need to search for an SOS internal 
representation character, it is easier to disable special 
pattern-matching and to search for the character directly. That is, 
type /MATCH: (note the colon) and then issue a Find command such as 
£<CTRL/F><ESC>. 
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The only time you are required to use ?7 is when you must use. other 
Special pattern-matching constructs ina search. In that case, you 
cannot first disable special pattern-matching. One such case would be 
a Substitute command that searches for <CTRL/F> and then uses it in a 
Substitute-string construct in the newstring argument (see Section 
7.1.2). 


7.1.2 Substitute-String Constructs 


When you use find-string constructs in the oldstring of a Substitute 
command, SOS keeps track of the first, second, ..., nth strings 
matched within each line by these constructs. The substitute-string 
constructs let you manipulate the strings matched by the special 
find-string constructs, without knowing the exact contents of the 
matched strings. 


Use these two constructs in substitute strings, that is, in the 
newsString arguments of Substitute commands. 


NOTE 


Do not attempt to use substitute-string 
constructs to refer to a string matched 
by ?> (beginning or end of line). A 
beginning or end of line thus matched is 
not included in SOS's count of matched 
strings. 


?*n?* Substitute nth String Matched 


This special construct gives you access to the first, second, ..., nth 
strings matched within a line by special find-string constructs. One 
possible use of this feature is in exchanging arguments of functions. 
For example, if you want to change all occurrences of 


FUNCTION (a,b) 
to: 
FUNCTION (b,a) 


for any arguments a and b, you can issue the following Substitute 
command: 


x/MATCH 
KSFUNCTIONC?)?/9PP/) GO FUNCTIONCPRK27Ks TREPK) GQ /157% 


2?" Substitute Next String Matched 


This construct is similar to the previous. one, When used in a 
substitute string, it specifies substituting the next string in the 
series of strings matched by find-string constructs. Thus, if you use 
the constructs ?*3?*?" in a substitute newstring, SOS substitutes the 
third and fourth strings matched within the line by find-string 
constructs. 
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7.1.3 Combining Find-String Constructs 


find-string constructs can be combined in a Find or Substitute command 
to give even greater versatility to SOS's pattern-searching features. 


Perhaps the most useful find-string construct to combine with others 
is ?%x (match any character except x). For example: 


2?%29 matches any character that is not alphanumeric. 
2B2+ matches any character other than a number. 
?%?2 matches any character except a lowercase letter. 


More than two find-string constructs can be combined. For example: 


?$?1?+ matches anything but one or more digits. This 
combined construct could be useful in searching a data 
file in which much of the text is multidigit numbers. 


?1?%?< matches one or more of any character except spaces or 
tabs. 


?$?7?& matches any character except the internal 
representation of the construct ?& (that is, anything 
but <CTRL/F>). 


SOS does not consider the beginning or end of a line aie character. 
Thus, the beginning or end of a line is matched by all of the 
following combined constructs (among others): 


2B?/ anything that is not a character 
PS? : not a separator 

?$2> not a space or tab 

2?B29 not alphanumeric 

PB?! not a letter 

PS2t not a number 


For example, you can search for all occurrences of the word "can" with 
the following combined construct. This Find command works if "can" 
begins or ends a sentence (assuming the EXACT switch is not on), or if 
it begins or ends a line. 


KeeyPican?Z?! GO 13/*»99 


7.2 SPECIFYING RANGES BY CONTENT 


For any Edit-mode command that requires a range of line numbers as an 
argument, you can implicitly specify the range by text content. 


For example, instead of requesting that SOS print the lines numbered 
from 150 through 220, you can request that SOS print all lines from 
the line in which the string ABC occurs through the line in which’ the 
string DEF occurs. (You can do this for any SOS command, not just the 
Print command.) 
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A common way to specify a range of lines is to use the following form: 
position: position 


To specify a range by content, replace either or both of the position 
specifications with arguments in the following form: 


és0 string 


Terminate the command with a final <RET>. For example, to issue the 
Print command cited above, type: 


xP ARC 
$ & DEF 
RET) 


Note that three carriage returns are required: one each to terminate 
the two content specifications, and a final one to terminate the Print 
command. Note also that a colon separates the two halves of the 
content-specified range. 


Using this kind of content specification is equivalent to embedding 
one or two Find commands within whatever command you are issuing. In 
executing the Print command given above, for instance, SOS performs a 
search for the string ABC as soon as you type the first <RET>. The 
search starts at the current line and proceeds to the end of the file. 
If SOS does not find the string, it prints an error message 
immediately after you type the first <RET>. 


Assuming ABC is found, SOS performs a second search, starting at the 
position of ABC, when you type the second <RET> (terminating the 
range). Again, SOS prints an error mesSage if it fails to find DEF. 
When you type the final <RET>, SOS performs the Print command, using 
the range of lines it has located in its two searches. 


Normally, SOS starts its search for a content-specified line at the 
current line. However, you can specify a range over which SOS is to 
search with the form: 


ESO string range 


For example, suppose the current line is beyond the first line on the 
current page that contains the string ABC. Without resetting the 
current line, you can effect the Print command given above by 
specifying /. as the range for SOS's content-specified search: 


xP G0 ARC EC /. GED 
$ @ DEF 
RET 


Content specification is more general still. After the range you can 
give options that specify: 


e An exact pattern match (upper- and lowercase) 
e A quasi-Decide mode 
e The nth occurrence of the given string. 


In other words, content specification has options that give it all the 
generality of a Find or Substitute command. 
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7D 
ESC [string] €0 trangei || yN eee ET) 


mn 
where: 


string 
Specifies the pattern SOS is to search for. Note that string is 
optional. If you omit it, SOS uses the string last used in the 
same position in a content specification. 


range 
Specifies the range over which SOS is to search for the string. 
If you omit range, SOS searches from the current line to the end 
of the file. 


Tells SOS to enter a quasi-Decide mode. SOS prints the first 
line containing the string, then prompts with ?. You type Y, y, 
or <SP> if the line printed is the line you intend for’ the 
content specification. sos then continues with the 
content-specified command. Type <DEL> to reject the line. sos 
then prints the next line in the range that contains the string, 
and again prompts with ?. If you reject all the lines in the 
range that contain the string, SOS prints an error message and 
terminates the content-specified command. 


N 

r 
Tells SOS to enter the same quasi-Decide mode, but instead of 
printing each line found, SOS prints only the line number, and 
prompts with ?. Type Y, y, or <SP> to accept the line; type 
<DEL> to reject it. 


mn 
An integer: tells SOS to use the nth occurrence of the string 
within the range. Note that the meaning of this option differs 
from its meaning in the Find command. In Find, ,n tells SOS _ to 
print the next n occurrences of a string, not its nth occurrence. 


E 

td 
Tells SOS to accept only an exact pattern match in its search for 
the string. Upper- and lowercase letters must match. Note: the 
EXACT switch, which controls exact pattern matching in the Find 
and Substitute commands, is also effective in content 
specifications. Turning on the EXACT switch has the same effect 
as specifying the ,E option. 


Tells SOS to use the first line in which the specified pattern 
does not occur, 


Content specification has still another sort of generality. The range 
that you can give in a content specification can itself be 
content-specified; the range in that content specification can also he 
content-specified. The maximum nesting depth is three levels. 
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For example, a file contains the following lines: 


00100 abc 
00200 cde 
00300 fgh 
00400 ijk 
00500 imn 
00600 opgq 
00700 rst ] 
00800 uvw 
00900 XYZ 
01000 123 
01100 234 
01200 uuo 
01300 890 


As indicated by the brackets, the user wants to print the lines 
between the first occurrence of o and the next occurrence of u, with 
the searches constrained to the range between the first occurrence of 
f£ and the next occurrence of 1. The following two-level, 
content-specified Print command performs this task: 


*p €&) o @& @ f tH GED Print lines from 0... Start searching 











at f... 
i «-e-continue 
RED) search until l. 
és) ou 80) ED .. through u. 
RED Do it. 
00600 Ora 
00790 rst 


06800 LIV 
* 


7.3 SOS SPECIAL CHARACTERS 


Table 7-2 shows all the nonalphabetic characters that have special 
meaning to SOS. The meaning of some characters depends on the context 
(for instance, <ESC> can have one of several meanings, depending on 
the mode SOS is operating in). ; 
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Table 7-2 
SOS Special Characters 






Character Meanings 



















Edit mode: Move Position command, 
In position specifier: means current line or current 


page. 






Edit mode: Give Parameter command. 
In Copy command: means text is copied from another 
file, 









In position specification: signifies a positive 
line-number offset. 
Special pattern-matching construct: match any 





decimal digit. 







Edit mode: Execute Command File command. 


Edit mode: Set Parameter command. 

In Copy command: /C means enter Copy-file mode. 

At DCL level: marks beginning of a qualifier. 

In position specifier: separates line number and 
page number. 

Special pattern-matching construct: match any 
character. 










In position specifier: means first line on a _ page, 
or first page in a file. 






In position specifier: means last line on a page, or 
last page in a file. 

Special pattern-matching construct: substitute the 
nth string matched by a special construct. 








In End, Save World, List commands: signals beginning 
of a file specification. 

In range specification: separates starting and 
ending positions. 

In Set Parameter command: signals beginning of 
parameter value. 

Special pattern-matching construct: match any 
separator. 











In range specification: signals relative number of 
lines. 

Special pattern-matching construct: match any letter 
(A-Z, a-Z). 








In Input, Replace commands: signals new line-number 
increment. 

In Copy, reNumber, Transfer commands: separates 
arguments. 

In End, Find, List, Print, Substitute, Save World, 
eXtend commands: separates command options (,A ,D ,E 
rF iN 7P a) rr). 























(continued on next page) 
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Table 7-2 (Cont.) 
SOS Special Characters 


Meanings 


In Find command and in content specification (all 
commands) : used as a command option. Tells SOS to 
find the first line not containing the specified 
pattern. 

In position specification: signifies a negative 
line-number offset. 


In Input, Replace commands: Signals temporary 
line-number increment for this command only. 


Default flag character for special pattern-matching. 
Default logical escape character. 


Special pattern-matching construct: match a space or 
tab. 


Special pattern-matching construct: match begining 
or end of line. 


Special pattern-matching construct: match any 
character except the given one. 


Special pattern-matching construct: match 0 or more 
of the given character. 


Special pattern-matching construct: match any 
uppercase letter, 


Special pattern-matching construct: substitute the 
next sequential string matched by a special 
construct, 


Edit mode: print previous line. 

Input mode: return to Edit mode. When used after 
, move to Alter mode. 

Alter/insert mode: return to Alter mode. 

Decide Alter/insert mode: return to Decide Alter 
mode. 

Decide mode: illegal. 

In Find, Substitute commands: delimits text strings 
for search and substitution. 


Alter mode: move intraline pointer back one 
character, 


Edit mode: print next line. 
Alter mode: print rest of line, finish intraline 
edit for this line. If entered from Input mode by 


the ESC sequence, return to Input’ mode. 
Alter/insert mode: print rest of line, finish 


intraline edit for this line. 
Decide Alter mode and Decide Alter/insert mode: 
print rest of line, return to Decide mode. 








(continued on next page) 





Character 


SPECIAL CONSTRUCTS AND CHARACTERS 


Table 7-2 (Cont.) 
SOS Special Characters 





Meaning 











Alter mode and Decide Alter mode: move intraline 
pointer back one character. 

Decide mode: no, do not make the change. 

All other modes: delete previous input character. 


Alter mode and Decide Alter mode: move intraline 
pointer forward one character. 
Decide mode: yes, make the change. 


Alter mode and Decide Alter mode: move intraline 
pointer to the end of the line. 


Input mode: when followed by €0 , change from 
Input mode to Alter mode and place intraline pointer 
at beginning of line. 


Alter mode and Decide Alter wmode: discard edits 
performed so far and place intraline pointer at 
beginning of line. 

Alter/insert mode and Decide Alter/insert mode: take 
as text and insert it into the text line. 








CHAPTER 8 


SOS INTERNALS 


This chapter describes how SOS performs text editing using temporary 
files, how the VAX/VMS operating system stores text processed by SOS, 
and how, with an understanding of SOS internals, you can use SOS more 
efficiently. 


8.1 TEMPORARY FILES 


Whenever you use the editor, SOS creates one or two temporary files to 
store changes you make to your file. These temporary files appear in 
your directory during an editing session. Their names are SOScnn.TM1 
and SOScnn.TM2, where c represents the terminal device controller and 
nn represents your terminal number. For example, if you are using 
terminal device name TTA4, SOS temporary files are named SOSA04.TMI1 or 
SOSA04.TM2. 


There are two events which, when they occur during an editing session, 
affect the status of these temporary files: the "wraparound" process 
and the Save World command. 


8.1.1 Wraparound 


As you edit a file, SOS reads lines into an internal edit buffer. 
This buffer is a storage area within the image; its size is set when 
SOS is linked, usually to 10,000 bytes. Lines stored in the edit 
buffer are immediately available to SOS. However, because the storage 
capacity of the edit buffer is limited, it may not be able to store 
the entire input file. Thus, the start of the edit buffer (in 
relation to the beginning of the input file) advances when SOS reads 
in more text than the buffer can store. 


After it reads lines of text into the edit buffer, SOS stores them in 
the temporary file SOScnn.TM1. Changes you make while editing are 
incorporated into this file. This process of passing text through the 
edit buffer to the temporary file continues as long as your editing 
does not reference a line that is no longer contained in the edit 
buffer. (You can examine the starting position of the edit buffer by 
using the =LOCATION parameter described in Section 6.1.) 


When you do call for editing on a line before the start of the edit 
buffer, SOS performs a wraparound. This means that SOS copies the 
rest of the file (from the current position to the end) to SOScnn.TM1. 
At this point, SOScnn.TM1 is a complete copy of your original file, 
with all edits to date incorporated. SOS then "rewinds" SOScnn.TMI1: 
it returns to the beginning of the temporary file and starts reading 
from it. 
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Thereafter, SOScnn.TMl serves as the input file for further editing. 
SOS closes your original file, and does not read it again. 


After rewinding, SOS creates a second temporary file, SOScnn.TM2, to 
which it writes lines passed through the edit buffer. SOS continues 
this pass-through operation until it finds the line referred to in 
your command. 


The next time wraparound is necessary, the temporary files switch 
roles. SOS rewinds both files, and uses SOScnn.TM2 (which now 
contains the most up-to-date copy of the file) for input. SOS passes 
text lines through the edit buffer and writes them to SOScnn.TMl. 
Neither file is closed. 


8.1.2 The Save World Command 


When you issue a Save World command, the temporary files again 
effectively switch roles. The temporary file being used for output is 
renamed to the file specifier given -- or provided by default -- in 
the Save World command. SOS closes this renamed file, and then opens 
it (read-only) for input. The temporary file that was used for input 
is rewound and thereafter is used for output. 


If you give another Save World command, or if you give an End command 
without a new file specification, SOS deletes the file created by the 
last Save World command before renaming the output temporary file. 


If you try to recover information from temporary files as described in 
Section 4.3.4, you may encounter some errors when SOS tries to read 
data near the end of the file. The errors occur because the file was 
never closed properly and has no end-of-file mark. You can simply 
delete the erroneous line(s). 


8.2 FORMAT OF TEXT LINES AND PAGE MARKS 


When stored in a line-numbered file, a line of text generated by SOS 
is a VAX-11 RMS” record. Its type is variable with fixed-length 


control. The SOS line number comprises the fixed-control access field 
of the VAX-11 RMS record. 


The text line has the following format: 


| Byte count n| Line number | cnax | char | ses char | 


The byte count, a 16-bit integer, is 2 more than the number of 
characters in the text line. The line number is also a 16-bit 
integer. The text consists of 500 or fewer characters (represented 
above by char) that do not include the characters <DEL> or <NU>. No 
<RET> or <LF> is present to terminate the text line; its end point is 
implied by the byte count. 








An SOS page mark is represented in a file by the following special 
case of the general format given above: 


Byte count 3 -1 (FF) | 
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When SOS displays such text lines, it prints the line number as a 
5-digit ASCII number; prints a <TAB>; prints the n-2 characters of 
text; and adds a <RET> and <LF> to the line. 


SOS does not print a page mark as such. Instead, when it displays 
text on a page other than the current page, it prints PAGE n. first. 


8.3 USING SOS EFFICIENTLY 


In Read-only mode, SOS does not write an output file. The 
pass-through and wraparound file-writing described above does not 
occur. For this reason, SOS uses far less system resources’ in 
Read-only mode. This is why it is best to use Read-only mode 
routinely whenever you only need to examine a file. (You might use 
symbol assignment to define a command such as 
READ:="EDIT/SOS/READONLY".) 


The most efficient way to use SOS in Edit mode is to avoid wraparound. 
You can do this by editing a file sequentially from beginning to end. 
If you never refer to a line earlier in the file than the position 
marked by LOCATION, SOS does not wrap the file. You minimize the need 
for costly and time-consuming file copying. 


SOS's wraparound behavior explains why writing an output file without 
line numbers (ES or ET commands) requires more processing time than 
leaving the line numbers in place (as mentioned in Section 5.4). 
Suppose, for example, that the current line is in the middle of the 
file when you issue an ES command. SOS passes text through the edit 
buffer until end of file; rewinds both temporary files; then passes 
the entire file through a second time, omitting line numbers. SOS 
then renames the output temporary file to the output name, destroys 
the other temporary file, and exits. 


If instead of an ES command you issue an E command, SOS need not pass 
the file through the edit buffer a second time. After first passing 
through to end of file, SOS renames the output temporary file to the 
output name, destroys the other temporary file, and exits. 


If you want to ignore line numbers, the best approach is to strip them 
from your input file when you initialize SOS: turn off the SOS switch 
/LINE by appending /NOLINE as a qualifier to the EDIT command line. 
With the /LINE switch turned off, SOS ignores any lines already 
present in the input file and automatically renumbers the file. Use E 
to exit from the editor; SOS stores the line numbers in the output 
file (unless you have turned off /SEQUENCE). 


This method of entering and exiting from SOS avoids using ES to remove 
line numbers and still produces an input file with uniformly 
incremented line numbers. The only cost is the small amount of disk 
space used to store the line numbers in the output file. 


APPENDIX A 


SUMMARY OF SOS FUNCTIONS AND FEATURES 


Table A-1 
SOS Modes of Operation 


Used for 


Edit Editing -- adding, changing text 
Input Typing in lines of text 

Alter Editing within a line 
Alter/insert Inserting text within Alter mode 


Read-only Examining a file without changing it 


Copy-file Searching, copying from another file 


Decide Deciding case by case on substitutions 
Decide Alter (Submode) Like Alter mode 


Decide Alter/insert (Submode) Like Alter/insert mode 





Alter 


Copy 


Delete 
End 
Find 


Heip 
Input 


Join 
Kill Page Mark 
List 


Mark 
reNumber 
Print 
Replace 


Substitute 


Transfer 
Save World 
eXtend 


Move Position 
Give Parameter 


Set Parameter 


Execute 
Command File 


RET 


Cesc) 


SUMMARY OF SOS FUNCTIONS AND FEATURES 


Table A-2 
Edit-Mode Commands: Function and Format 


Function 





Enter Alter mode for intraline, 
character-by-character editing. 


Copy a range of lines to another place 
within a file, or from another file. 
Optionally, enter Copy-file mode. 


Delete a range of lines. 
End SOS, return to DCL. 


Search for the occurrence of one or 
more specified strings of text. 


Display the help package. 


Enter Input mode to insert lines of 
text. 


Join two text lines into one line. 
Delete a page mark. 


List a range of lines on the printer 
or to a file. 


Insert a page mark. 
Renumber a range of lines. 
Print a range of lines on the terminal. 


Delete a range of lines and enter Input 
mode. 


Replace one or more text strings with 
other string(s) in a range of lines. 
Optionally, enter Decide mode. 


Copy a range of lines to a new location 
and delete the original lines. 


Write a new file containing all the 
changes made so far. 


Enter Alter/insert mode to add text 
to the end of a line. 


Reset the position of the current line. 


Give the value of an SOS internal 
parameter or switch. 


Reset an SOS parameter or switch. 


Execute the SOS commands contained 
in a command file. 


Print next line. 
Print previous line. 


Format! 
A [range] 


C position [=file-spec] ,range[,incr1 [,incr2] ] 
position=file-spec/C 


D [range] 
E [B} [Q] [S] (T] [:file-spec] 
F [[string] Cesc [range] [,A] [.N} LE] [2] L-J] 


H [:n] 


siner 
I [position]] < ;iner 
sin 


J [position] 
K /page 


L [range] [.S] [{ .P[:file-spec] }] 
[{,F:file-spec }] 


M [position] 
N [incr] [, [range] [,start] ] 
P [range] [,S] 


,iner 
R [range] sincr 
sin 


S [[oldstring (esc )newstring] {range] [,D] [.N] LE} ] 


T position,range[,iner1 [,incr2] ] 
W [B] [:file-spec] 
X [range] [,N] 


. position 
= parameter 


/ parameter [:value] 


@ file-spec 


RET 


Cc) 





’ The space after the single-character command is optional. Terminate each command with (except the commands 


and Cesc )). 
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Definitions for the Edit-Mode Commands 


Uppercase letters represent literals that you type verbatim. (sos 
accepts either upper- or lowercase letters.) Lowercase terms represent 
variables, defined below. The symbol => means "is defined as." 


Brackets ([ ]) indicate optional parts of the argument string (except 
in directory or file-spec, in which one set of brackets must be 
typed). Stacked braces ({ }) mean to choose one of the enclosed 
expressions. Angle-brackets (< >) enclose descriptive terms. And 
<ESC> represents the escape key (or ALTmode, SELect or PREfix). 


file-spec =>[{device:][[directory]]filename[.type[;version]] 
increment => <a positive integer line-number increment> 


1 => <a line number> (less than 65536) 


> a 


line = [+ m] 
* 
m => <an integer line-number offset> 
n => <a positive integer> 
p => <a page number> 
Pp 
page =>) * [+ q] 
* 
parameter => <a legal SOS parameter or switch> 


position 7 line [/page] \ 
/page 


q => <an integer page-number offset> 
position [ff sas ona 
\ In 
range => 
:position 
tn 


start => <a positive integer line number> 


string => stringl[ string2[ String3{ string4 
[ string5[ string4]]1]]] 


value => <a legal parameter value> 


SUMMARY OF SOS FUNCTIONS AND FEATURES 


Table A-3 
Meanings of Edit-Mode Command Options 

















Meaning Commands 
Enter Alter mode Find 
Enter Decide mode Substitute 


Enter quasi-Decide mode Content specification 


(all commands) 
Require exact case match Find, Substitute, 
content specification 
(all commands) 


List to disk file List 


Type only number, not line Find, eXtend, content 
specification with substitute, 
prints nothing 


Select printer List 


Suppress line numbers List, Print 


Find line in which specified 
pattern does not occur 


Find, content specification (all 
commands) 

Find n occurrences of Find 
specified pattern 


Use nth occurrence of 
specified pattern 


Content specification (all 
commands) 





Table A-4 
Alter-Mode Commands 


Command Meaning 








Do not print rest of line; recycle to beginning 
of line with edits incorporated. 


{[-] [n]Cx... Change next/previous n_ characters to given 
characters.1 


[-] [n]D Delete next/previous n characters. 
E End Alter mode for this line; do not print line, 


[-] [n] Itext GQ |Insert text after/before pointer; use temporary 
increment n for new lines. 


(n]J Split line after pointer; use increment n. 











1 "Next" if no minus sign is typed: "previous" if minus. sign is 
typed. The other commands that accept a minus sign are presented 
in similar fashion. 


(continued on next page) 
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Table A-4 (Cont.) 
Alter-Mode Commands 


| commana framing 


Kill (delete) all until nth occurrence of 
character x. 






Print rest of line; recycle to beginning of line 
with edits incorporated. 








Print rest of line; recycle to current position 
with edits incorporated. 













Q Quit Alter mode; restore original line. 








[-] [n]Rtext 0 |Replace next/previous n characters with inserted 


text. 











[-] [n] Sx Skip forward/back to nth occurrence of character 


Xe 








[-] [n] w 
[Stns 
ae aah 
[-] [n]< 
[-] [n]> 
(-] [n] 


Skip forward/back n words. 






Delete next/previous n words. 








Invert case of next/previous n characters. 






Convert next/previous n characters to uppercase. 





Convert next/previous n characters to lowercase. 





back/forward n characters. 





Space 











Leave Alter mode for this line; print rest of 
line. : 






Space back/forward n characters. 





Leave Alter mode for this line; print rest of 
line. 







characters, 






forward/back n 





Space 


Skip to end/start of line, 






Retype line to current position. 





Start fresh -- discard edits, recycle to 
beginning of line, do not print line. 





SUMMARY OF SOS FUNCTIONS AND FEATURES 


Table A-5 
Decide-Mode Commands 













Meaning 





Yes, make the change as shown, 
No, do not make the change. 


Alter: enter Decide Alter mode with the change 
already made. 


End: do not make the change, return to Edit mode. 


Go: make the change, and make all further changes 
automatically (leave Decide mode). 





Table A-6 
SOS Parameters 



























Name! Set from : Preset A Meaning 
Edit Mode? via DCL? 

BIG n - Displays highest page number 
ERROr n (null) Displays last error message 
ESCApe y (null) Sets character for input/output of escapes 
1D n = Displays current SOS version number 
INCRement y y 100 Sets increment for numbering inserted lines 
ISAVe y y 0 Controls auto-W on inserts 
LENGth y 55 Sets page size for List command 
LOCAtion n “fl Displays first line in edit buffer 
MATCh y (null) Sets special pattern-matching flag character 
NAME n - Displays output file specification 
PLINes y y 16 Sets number of lines printed by PCRET_) 
SAVE y y 0 Controls auto-W on commands 
STARt y y 100 Sets starting line number 
STEP y y 100 Sets increment for initial line numbering 
STRIng n (null) Displays current Find and Substitute strings 
SUBStitute n 0 Displays number of matches in last Substitute 
: n 











00000/1 Displays current position 

' Minimum abbreviation is given in uppercase letters. 

2 You can specify these parameters as qualifiers in the initial DCL EDIT command, or by using the symbol- 
assignment mechanism (see Section 6.3). 
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Table A-7 
SOS Switches 


Meaning 








BAK Tells SOS to create back-up file 
DEClde y Sets auto Decide mode on Substitute 


EXACt Requires exact case match for Find, Substitute, content- 
specification 


EXPErt Declares experienced SOS user 


LINE Tells SOS to use existing line numbers 
LOWEr Tells SOS to accept uppercase, lowercase as is 
NUMbers Tells SOS to display line numbers 
READonly Starts SOS in Read-only mode 

SEPArator Tells SOS to treat _$ . as alphanumeric 
SEQUence Leaves output-file line numbers 








1 Minimum abbreviation is given in uppercase letters. 

2 You can specify these switches as qualifiers in the initial DCL EDIT command, or by using the symbol- 
assignment mechanism (see Section 6.3). Turn off any switch by using the letters NO before its name; 
thus, NOLINE turns off the LINE switch. 





Con- 
struct 
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Internal 
Represen- 
tation 


Table A-8 








Meaning 





Find-String Constructs 


?/ 
Ps 
?< 
2 &X 
?)x 
?1lx 
29 
/! 
?& 
?2 
P+ 
?> 
?7c 


Bee Eee eae 


Match 
Match 
Match 
Match 
Match 
Match 
Match 
Match 
Match 
Match 
Match 
Match 
Match 





any character 

any separator 

a space or tab 

any character except x 

0 or more of the character x 
l or more of the character x 
any alphanumeric character 
any letter (A-Z, a-z) 

any uppercase letter (AZ) 
any lowercase letter (a-z) 
any decimal digit (0-9) 
beginning or end of line 
internal representation of c 


Substitute-String Constructs 


Pelee 


P*22* 


The first string matched by a find-string 
construct 


The second string so matched 


The nth string so matched 


The next string in the sequence matched 


by a find-string construct 


Table A-9 


Position Shorthand Characters 





Meaning 


Current line 
Current page 
First line on page 


First page in file 


Last line on page 


Last page in file 





APPENDIX B 


SOS ERROR MESSAGES: NOVICE AND EXPERT FORMS 


Table B-1l lists 
right-hand column 
the EXPERT switch is on (see Section 6.2). 


the error messages 


produced by sos. In 
are the forms of the messages that SOS prints if 
All the messages 


the 


except 


one are nonfatal: SOS halts the offending command and returns you to 


Edit mode. The one fatal error is the last 
SOS. Sorry.). 


does occur, SOS returns you to the monitor. 


Table B-l 


one 
This error does not occur in normal SOS use. 
See 
possible recovery procedures in this eventuality. 


confounded 
If it 
for 


(You 


Section 4.3 


SOS Error Messages: Novice and Expert Forms 


Novice Message 


Bad command file name 

Cannot access HELP file 

Cannot access LIST file 

Cannot delete across pages 

Cannot kill initial page mark 

Command invalid for read only file 
Command line I/O error 

Failed to open command file 

Illegal file specification 

Illegal parameter to switch 

Illegal search string given 

Illegal specification in line or page number 
Illegal specification in range 

Tllegal switch name 

Illegal syntax of command 

Insufficient line numbers for insertion 
Line is too long 

Line number step too large —- lines out of order 
Lines out of order 

Maximum command file depth exceeded 

No such line exists 

Page does not exist 

Range given does not contain any lines 
Search strings exceeded buffer length 
String not found, search failed 

Too many search strings given 

You confounded SOS. Sorry. 


Expert Message 


Name bad 

HELP trouble 

LIST trouble 

Del no pages 

K/1 bad 

File RO 

I/O error 

Open failure 

File? 

Bad param to switch 
Iss 
Bad 
Bad 
Bad 
?? 
No room 

Line too long 

Step too big 

Order 

Command files too deep 
NSL 

Page? 

Nothing 

Too long 

Not there 

Too many 

Internal error 


line/page 
range 
switch 





A 


Adding lines. See Alter-insert 
mode, Input mode 
Alter (A) command, 5-4 
Alter-insert mode versus Input 
mode, 3-8 
Alter-insert mode, 2-6, 5-9 
Alter mode, 2-6, 5-4 
Alter-mode commands 
B (recycle), 5-7 
<BS>, 5-15 
C (change), 5-8 
<CTRL/R>, 5-16 
<CTRL/U>, 5-17 
D (delete), 5-9 
<DEL>, 5-15 
E (end), 5-9 
I (insert), 5-9 
J (split), 5-11 
K (kill characters), 5-11 
L (line), 5-11 
<LF>, 5-16 
P (print), 5-12 
Q (quit), 5-12 
R (replace), 5-13 
<RET>, 5-15 
S (skip), 5-13 
<SP>, 5-16 
summary of, 5-5, 5-6 
<TAB>, 5-16 
(word), 5-14 
(delete word), 5-14 
(convert to uppercase), 5-14 
(convert to lowercase), 5-15 
(invert case), 5-14 
Arithmetic expression in range, 
3-6 
Asterisk (*), last line or page, 
3-3 
At sign (@), Execute Command 
File, 5-56 
Automatic file saving, 4-2. See 
also ISAVE parameter and 
SAVE parameter 


IVAKS 


Back-up file. See Save World (WwW) 
command; End (E) command 

BAK switch, 6-10, 6-11 

BIG parameter, 6-3 

Built-in safety features on SOS, 
4-2 


INDEX 


C 


Caret (“), first line or page, 
3-3. See also Alter mode 
Characters, 
control, 1-2 
special, 7-9 to 7-12 
terminal usage of upper/lower- 
case, 1-4 
Colon (:), 3-2 
Command File (@) command. See 
Execute Command File (@) 
command 
Commands, 
Alter (A), 5-4 
Copy (C), 5-18 
Delete (D), 5-22 
End (E), 5-23 
Execute Command File (@), 5-56 
extend (X), 5-51 
Find (F), 5-25 
Give Parameter, (=), 5-54 
Help (H), 5-29 
Input (I--Input mode), 5-30 
Join (J), 5-33 
Kill Page Mark (K), 5-34 
List (L), 5-35 
Mark (M), 5-36 
Move Position (.), 3-4, 5-53, 
Print (P), 5-39 
reNumber (N), 5-37 
Replace (R), 5-41 
Save World (W), 4-2, 5-50, 
8-2 
Set Parameter (/), 5-55 
Substitute (S), 5-43 to 5-46 
Transfer (T), 5-47 
See also Alter-mode; Decide- 
mode; Edit-mode 
Complete range specification. 
See Default, line and page 
number 
Confirmation before deleting. 
See Delete (D) command; 
Replace (R) command 
Constructs, 
combining find-string, 7-6 
find-string, 7-2 
special pattern-matching, 7-1 
substitute-string, 7-5 
Content, 
nested, 7-8 
specification, range by, 7-6 
to 7-8 
syntax, 7-8 


Index-1 


Control characters, 1-2, 2-6 

Conversion of upper/lowercase 
characters, 5-14, 5-15 

Copy (C) command, 5-18 to 5-21 

Copy-file mode, 2-5, 5-20 

Current line. See Current posi- 
tion 

Current line-number increment, 
3-8 


Current position, 3-4 


D 


Decide Alter mode. See Decide- 
mode commands 

Decide Alter/insert mode. See 
Decide-mode commands 

Decide mode, 2-1, 2-2, 5-46. 
See also Quasi-Decide mode 


Decide-mode commands, 2-2, 5-46 
Alter (A) mode, 2-2, 5-46 
Decide Alter mode, 2-2, 5-46 


Decide Alter/insert mode, 2-2, 
5-46 
DECIDE switch, 
Default, 
conditions when SOS initiated, 
4-1 
line and page number, 3-4, 
parameters and switches, 6- 
to 6-14 
setting by symbol assignment, 
6-14 
Delete 
Alter mode and, 5-5, 
5-10, 5-11, 5-14 
Delete (D) command, 
<DEL> character, 1-3 
eXtend command (X) and, 5-51 
Kill (K) command and, 5-34 
summary of uses, 7-12 
Dollar sign ($), 1-3, 6-4 


6-11 


3-5 
3 


5-9 , 


5-22 


E 


Edit buffer, 6-6, 8-1 
Edit mode, 2-3 
Edit-mode commands, 
form and function, 
Efficient use of SOS, 
End (E) command, 5-23 
Equal sign (=), 
Copy-file mode, 5-20 
Give Parameter command, 
Error messages, B-l 
ERROR parameter, 6-3 


5-1 
2-4 
8-3 


5-54 


INDEX 


Escape character (<ESC>), 


as abbreviated Print command, 


5-39 
use of, 1-3 
ESCAPE parameter, 6-4 
Execute Command File and, 
EXACT switch, 
description of, 6-12 
substitute options and, 


5-57 


5-46 


Execute Command File (@) com- 


mand, 5-56 
Exclamation point (!) 3-2 
EXPERT switch, 6-12 


error message forms when on, 


eXtend (X) command, 5-51 


F 


Find (F) command, 5-25 
Find-string constructs, 

combining, 7-6 
Format, 
and page marks, 8-2 


G 


7-2 


B-1 


internal, of text lines 


Give Parameter (=) command, 5-54 
Help (H) command, 5-29 
ID parameter, 6-5 
INCREMENT parameter, 6-5 
Current-Line Number, 3-8 
Initiating SOS, 1-2 
Input mode, 
command (I--Input mode), 5-30 
description, 2-2 
versus Alter/input mode, 3-8 
Inserting lines, 
Alter/insert mode, 2-6, 5-9 
Input mode, 2-2, 5-30 
ISAVE parameter, 4-2, 4-3, 6-5 
Join (J) command, 5-33 
Kill Page Mark (K) command, 5-34 


Index-2 


INDEX 


L 


LENGTH parameter, 6-6 
Limitations of SOS, 4-1 
Line length restriction, 4-1 
Line numbers 
Current, increment, 3-8 
defaults for, 3-4 
description of, 3-1 
how SOS assigns new, 3-7 
offsets, 3-6 
ranges, 3-2 
restrictions, 4-2 
when existing line intervenes, 
3-8 
Line number syntax, 3-7 
LINE switch, 6-13 
List (L) command, 5-35 
LOCATION parameter, 6-6 
LOGIN.COM file, 6-14 
Lowercase characters, 4-1 
uppercase and, 1-4, 5-14, 5-15 
LOWER switch, 6-13 


Mark (M) command, 5-36 
MATCH parameter, 
description of, 6-7 
Find command and, 7-2 
Minus sign (-), 
Delete command and, 5-9 
Find command and, 5-25 
line-/page-number offset, 3-6 
setting default conditions, 6-14 
Modes of operation, 
Alter, 2-6, 5-4 
Alter/insert, 2-6, 5-9 
Copy-file, 2-5, 5-20 
Decide, 2-5, 5-46 
Decide Alter, 2-2, 5-46 
Decide Alter/insert, 2-2 
description, 2-1 
Edit, 2-3, 5-1 
Input, 2-2, 5-30 
Read-only, 2-3 
Modules, Help, 5-29 
Move Position (.) command, 3-4, 
5-53 
Multiple search strings, 5-27, 
6-9 
Multiple substitutions, 5-45 


N 


NAME parameter, 6-7 
Numbers, 
Line, 3-1 


Numbers, (Cont.) 
new line, 3-7 
Page, 3-l 

NUMBERS switch, 6-13 


O 


Offsets, line- and page-number, 
3-6 
Options, 
content specification and, 7-7 
Decide mode and, 5-46 
Find (F) command, 5-27 
Substitute (S) command, 5-45 
Output file, 1-2 


p 


Page boundary, 
arithmetic expressions and, 
3-6 
deleting across, 5-22, 5-42 
line-number offset and, 3-6 
ranges of line numbers and, 
3-2 
Page numbers, 
Copy (C) command and, 5-19 
description of, 3-1 
format of, 8-2 
Mark (M) command and, 5-36 
offset, 3-7 
syntax, 3-7 
Transfer (T) command and, 5-47 
Parameters, 6-1 to 6-10 
BIG, 6-3 
description of SOS, 6-l 
ERROR, 6-3 
ESCAPE, 6-4 
ID, 6-5 
INCREMENT, 3-8, 6-5 
ISAVE, 4-2, 6-5 


LENGTH, 5-35, 6-6 
LOCATION, 6-6 
MATCH, 6-7, 7-1 


NAME, 6-7 
PLINES, 6-8 
SAVE, 4-2, 6-8 
Set Parameter (/) command, 
5-55 
START, 6-8 
STEP, 6-9 
STRING, 6-9 
SUBSTITUTE, 6-10 
Partial range specification. 
See Default, line and page 
number 
Pattern-matching constructs, 
special, 7-1 


Index-3 


Period (.), 
Move Position (.) command, 
5-53 
parameter, 6-10 
shorthand character, 3-3 
PLINES parameter, 6-8 
Plus sign (+), 3-6 
Pointer, 
current-line, 3-4 
intraline, 5-4 
Position syntax, 3-2 
Print (P) command, 5-39 


Q 


Quasi-Decide mode, 7-8 
Question mark, special pattern- 
matching flag, 6-7, 7-1 


R 


Range of line numbers, 3-2 
Range, line-number syntax, 3-3 
Read-only mode, 2-3 
efficiency of, 8-3 
ReNumber (N) command, 
automatic after deletion, 5-22 
description of, 5-37 
Replace (R) command, 5-41 
Restrictions on SOS, 4-1 
Return character <RET> as 
abbreviated Print command, 
5-40 


S 


Safety, SOS built-in features, 
4-2 
SAVE parameter, 4-2, 6-8 
Save World (W) command, 4-2, 
6-8, 8-2 
SEPARATOR switch, 6-14 
SEQUENCE switch, 6-14 
Set Parameter (/) command, 5-55 
Shorthand characters, 3-3 
Slash (/) 
file specification qualifiers 
and, 1-2 
line position specification 
and, 3-2 
Set Parameter (/) command, 
5-55 
Special characters, 7-9 to 7-12 
Special pattern-matching, 6-7, 
7-1 to 7-9 


INDEX 


Specifying ranges by content, 
7-6 
START parameter, 6-8 
STEP parameter, 6-9 
String length restriction, 4-2 
STRING parameter, 6-9 
Submodes, 2-2 
Substitute (S) command, 5-43 
SUBSTITUTE parameter, 6-10 
Substitute-string constructs, 
7-5 
Switches, 6-1, 6-10 to 6-15 
abbreviating names of, 6-1ll 
BAK, 6-11 
DECIDE, 6-11 
EXACT, 6-12, 5-46 
EXPERT, 6-12, B-1 
LINE, 6-13 
LOWER, 6-13 
NUMBERS, ‘6-13 
SEPARATOR, 6-14 
SEQUENCE, 6-14 
turning off, 6-1, 6-11 
Symbol assignment, 
setting default conditions 
using, 6-14 
Syntax, 
line number, 3-7 
page number, 3-7 
position, 3-2 
range, 3-3 


T 


Temporary files, 
description of, 8-l 
recovering information from, 
4-3 
Terminating SOS, 1-2 
Text line, format of, 8-2 
Textual file, 5-24 
Transfer (T) command, 5-47 


U 


Up-arrow (4), first line or 
page, 3-3 
See also Alter mode 
Upper- and lowercase characters, 
1-4 
conversion, 5-14, 5-15 


W 


World, Save (W) command, 4-2, 
6-8, 8-2 
Wraparound, 8-l 


Index-4 


riease cur aiong mis imine, 
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READER'S COMMENTS 


This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR), service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 








Did you find errors in this manual? If so, specify the error and the 
page number. 




















Please indicate the type of reader that you most nearly represent. 


OOOOO0O 


Name 


Assembly language programmer 
Higher-level language programmer 
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